Content
30%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 body is a near-empty stub: it repeats the description three times, provides no actionable guidance, no workflow, and defers everything to an external GitHub link with no bundled references. Brevity is the only strength, and it comes from an absence of content rather than efficient writing.
Suggestions
Replace 'This skill provides guidance and patterns' with concrete, executable instructions or code examples for the actual scientific tasks the skill covers — this is the single largest gap (actionability 1).
If the skill has real content in the source repository, bring key material into bundled reference files (e.g., references/analysis.md) and link them from the body instead of relying on an external URL.
Remove the redundant repetition of 'scientific research and analysis skills' across the Overview, When to Use, and Instructions sections, and give each section distinct, useful content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is brief and doesn't explain concepts Claude already knows, but the identical phrase 'scientific research and analysis skills' is repeated three times across sections with no new information — 'Efficient; minor instances ... that could be trimmed'. It is not a 5 because several tokens (the repeated Overview/When-to-Use boilerplate) earn nothing. | 4 / 5 |
Actionability | The Instructions section only says 'This skill provides guidance and patterns for scientific research and analysis skills' — no code, commands, examples, or specific steps; it merely points to an external GitHub URL. This matches 'Entirely vague or abstract; no concrete code or commands; only describes rather than instructs'. | 1 / 5 |
Workflow Clarity | No process is described at all — no steps, sequence, or validation checkpoints of any kind, matching 'Steps missing or incoherent; no sequence'. The body is a stub with nothing to sequence. | 1 / 5 |
Progressive Disclosure | Sections (Overview, When to Use, Instructions) are present and organized, and no bundle files exist to reference. However, all substantive content is deferred to an external repository URL rather than bundled reference files, making the SKILL.md a pointer stub — matching 'Some structure but could be better organized' rather than a well-split 5, since navigation to actual content depends on an external site. | 3 / 5 |
Total | 9 / 20 Passed |