Content
82%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.
A well-built operational skill body: fully executable commands, a clear four-step workflow with cross-project and reproducibility controls, and genuine one-level-deep references to real bundle files. Weaknesses are minor — some path repetition, no explicit validation checkpoint for the LLM JSON before merging, and under-signaled references.
Suggestions
State the reviewer script path once (e.g., only in the Workflow intro) and have the Installation section reference it instead of repeating the full path three times.
Add a validation checkpoint in Step 2 or 3, e.g. 'Verify the LLM JSON parses and follows references/llm_review_schema.md before merging; re-ask if fields are missing or malformed.'
Annotate the Resources references with what each contains and when to read it (e.g., 'LLM schema: read before producing the Step 2 JSON — references/llm_review_schema.md').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — no concept explanations Claude already knows, and every section carries operational content (commands, flags, output paths). It sits at 4 rather than 5 because of minor trimmable repetition: the reviewer script path is stated three times (Workflow bullets, the bash comment block, and the Installation section), and the Resources section partially restates scoring behavior already implied by the workflow. | 4 / 5 |
Actionability | Every step ships copy-paste-ready commands with real flags ('uv run "$REVIEWER" --project-root . --emit-llm-prompt --output-dir reports/'), concrete output filenames, and specific weight arguments. Even the orchestration-oriented Step 2 gives exact instructions (read the generated prompt file, return strict JSON, save for merge), matching the score-5 'fully executable' anchor rather than 4, which would require minor gaps. | 5 / 5 |
Workflow Clarity | Steps 1-4 are clearly sequenced with commands per step, plus an Optional Controls section. It is 4 rather than 5 because there are no explicit validation checkpoints (e.g., 'verify the LLM JSON matches the schema before merging' would be a natural one) — Step 2 only says 'Ask the LLM to return strict JSON output' without a verify/retry loop. | 4 / 5 |
Progressive Disclosure | The body is a well-organized overview with one-level-deep references to real bundle files ('LLM schema: references/llm_review_schema.md', 'Rubric detail: references/scoring_rubric.md') and the script path, all of which exist. It is 4 rather than 5 because the references appear only as bare paths at the bottom without signaling what each contains or when to read it, and the skills-index output explanation is inline where a pointer could serve. | 4 / 5 |
Total | 17 / 20 Passed |