Content
57%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content communicates a usable workflow with clear invocation modes and a concrete startup template, but execution details are thin (no commands for the load/search steps), validation is absent, and the custom pseudo-XML structure — including an unclosed <workflow> tag — makes the document fragile to parse. Converting the tag soup into ordinary markdown sections with concrete commands would lift most dimensions.
Suggestions
Replace the custom <guidelines>/<workflow>/<end_goal> tags with standard markdown lists and headings, and fix the malformed second '<workflow>' tag on line 40 (it should be '</workflow>') so the step container is well-formed.
Add concrete commands to the workflow steps — e.g. 'git clone --depth 1 <url> ~/.btca/agent/sandbox/<repo>' for load and 'git pull --ff-only' for update — so the load step is executable rather than descriptive.
Add a validation checkpoint before search, e.g. confirm the repo directory exists and is a git repository ('test -d ~/.btca/agent/sandbox/<repo>/.git'), and specify which tools (grep/rg, file listing) to use for the search step.
Consolidate the three 'Startup Cases' into the workflow section or a single 'Invocation modes' list so all behavioral rules live in one coherent structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean for its scope: no explanations of concepts Claude already knows, and content is limited to workflow rules and invocation cases. Minor instances of chatty filler could be trimmed ('this one's simple, simply answer the users prompt', 'almost as if a terminal app was booted up'), matching 'Efficient; minor instances of over-explanation that could be trimmed' rather than anchor 5 where every token earns its place. | 4 / 5 |
Actionability | Concrete elements exist — the exact sandbox path '~/.btca/agent/sandbox', a default-branch clone rule, and a copy-paste startup output template — but the core workflow offers no executable commands for cloning, updating, or searching ('search the repo for the information you need', 'update them'), so guidance is incomplete as in 'Some concrete guidance but incomplete'. It is not anchor 4 because none of the load/search steps could be executed as written without Claude supplying all specifics itself. | 3 / 5 |
Workflow Clarity | A real three-step sequence exists (work dir setup → load → search) plus three clearly separated invocation cases, but there are no validation checkpoints (e.g. confirming a clone succeeded or a repo exists before searching) and the structure is broken by a malformed tag — line 40 opens a second '<workflow>' instead of closing the first, corrupting the step container. This lands on 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit'; it is above anchor 2 because the sequence is coherent and the startup states are well-defined. | 3 / 5 |
Progressive Disclosure | The skill has no bundle files and is short enough that a single SKILL.md is arguably appropriate, but the in-file organization undercuts navigation: custom XML pseudo-tags (<guidelines>, <workflow>, <end_goal>) are mixed with markdown headings, one tag is malformed, and the 'Startup Cases' section sits outside the tag structure. This matches 'Some structure but could be better organized'; it is not anchor 4 because the structure a reader must parse is inconsistent rather than having only minor gaps. | 3 / 5 |
Total | 13 / 20 Passed |