Content
71%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 lean, well-organized instruction skill with genuinely useful, non-generic writing discipline (paragraph patterns, claim vocabulary, anti-overcorrection). Its main defects are structural: both external reference links are broken (the files do not exist), and one guideline is misfiled under References, which undermines the otherwise good progressive-disclosure design.
Suggestions
Fix the broken references: either create ../_references/section-patterns-and-story.md and ../_references/style-and-revision-checks.md with the promised content, or remove the links and inline the essential patterns.
Move the misfiled bullet 'Avoid collapsing unsupported mechanistic speculation into factual statements' out of 'References' and into 'Tense and claim discipline', where it duplicates existing guidance.
Add one compact worked example (a weak claim sentence rewritten with 'is consistent with / suggests') to make the claim-discipline rules copy-paste applicable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~50-line body is tight and assumes Claude's competence (no explanation of what Results/Discussion sections are, no writing tutorial padding), and every section adds skill-specific discipline. Minor trimming is possible: the mechanistic-speculation rule appears in both 'Tense and claim discipline' ("Do not let mechanistic speculation read like fact") and again in 'References' ("Avoid collapsing unsupported mechanistic speculation into factual statements"), and anti-hedging advice is likewise stated twice. This matches 'efficient; minor instances that could be trimmed', not the 3 anchor's 'some unnecessary explanation'. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is concrete: numbered paragraph patterns (question/observation/takeaway; interpretation/support/comparison/limitation), a default-selection rule, and specific hedging vocabulary ("is consistent with", "suggests", "may reflect") that can be applied directly. It stops short of the 5 anchor because there are no worked examples (e.g., a before/after sentence pair or a sample paragraph) covering common cases. | 4 / 5 |
Workflow Clarity | The 5-step Workflow is clearly sequenced (placement decision → observation-first Results → meaning/comparison/uncertainty Discussion → robust-vs-tentative separation → closing scope), with concrete paragraph patterns to execute each step. The destructive/batch validation cap does not apply to a writing task, but self-check/revision checkpoints (e.g., 'verify each observation is anchored to a figure') are only implicit and the revision pass is deferred to a reference file, so it fits 'clear sequence with most checkpoints; minor validation gaps' rather than the 5 anchor's explicit validation steps. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned and its two references are clearly signaled with markdown links and one-line descriptions of what each contains. However, both referenced paths ([../_references/section-patterns-and-story.md] and [../_references/style-and-revision-checks.md]) do not exist — there are no bundle files anywhere in the skill directory — so the promised navigation is broken. Additionally, the 'References' section opens with a misplaced guideline bullet ('Avoid collapsing unsupported mechanistic speculation...') that is a rule, not a reference. This lands at 'some structure but could be better organized' rather than the 4 anchor, whose references must actually resolve. | 3 / 5 |
Total | 15 / 20 Passed |