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-structured, highly actionable skill body with effective progressive disclosure to real, one-level-deep reference files. The main improvements are removing duplicated bulk-workflow guidance and closing minor validation gaps (e.g., 429 retry handling, explicit bulk-output verification).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and operational — wrapper CLI rules, rate limits, jq recipes, and context-management tactics Claude cannot know — with no explanations of concepts Claude already knows. It falls short of the 5 anchor due to trimmable redundancy: the "avoid one-by-one / prevents turn exhaustion and context overflow" guidance appears nearly verbatim in both Context Management and Bulk Workflows, the folder-structure listing duplicates the reference links in Functions, and the MANDATORY warning block is emphatic and padded. Score 3 would require more substantial unnecessary explanation, which is absent. | 4 / 5 |
Actionability | Guidance is fully executable and copy-paste ready: `uv run scripts/pubmed_api.py ./search_results.json search_pubmed "BRCA1" --max_results 5`, the "Join PMIDs" chaining recipe, and null-safe jq slimming/filtering recipes cover the common search→fetch→process cases end-to-end. This matches the 5 anchor (specific examples cover the common cases); score 4 would imply gaps in the executable examples, which are not present. | 5 / 5 |
Workflow Clarity | Multi-step workflows are clearly sequenced (search → join PMIDs → fetch → slim → read) with most checkpoints documented: non-zero exit-code error handling, "Filter Early" verification before reading into context, grounding rules, and explicit search-termination limits. It falls short of the 5 anchor because no full validate→fix→retry feedback loop exists (e.g., no retry guidance for 429 errors beyond obtaining an API key, and the bulk workflow lacks an explicit output-verification checkpoint); it stays above the 3 anchor because validation signals (exit codes, filter-early, termination limits) are explicitly stated rather than missing. | 4 / 5 |
Progressive Disclosure | SKILL.md is a clear overview with one-line function tables, a mandatory read-before-call rule, and one-level-deep references that all exist and are well-signaled from the function section headers (verified against the actual bundle). Score 5 is blocked by minor navigation gaps: three reference files (advanced-linking.md, advanced-search.md, citation-matching.md) appear only in the flat folder-structure listing rather than being linked from their relevant sections — e.g., match_raw_citations points to utilities.md while the dedicated citation-matching.md guide is discoverable only via the folder listing. Score 3 would require content that should be separate inlined or buried references, which is not the case. | 4 / 5 |
Total | 17 / 20 Passed |