Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-sequenced, actionable instruction skill with strong workflow clarity and a real verification/feedback loop. Its weaknesses are moderate internal redundancy and a monolithic structure with no progressive disclosure for a longer-than-trivial skill.
Suggestions
Remove the 'Key Rules' section or replace it with a one-line pointer to the relevant workflow steps, since it duplicates Step 3/4/5/8 guidance and inflates the token budget.
Split the 'Required File Structure' template and the per-status 'Output Modes' detail into a referenced reference file (e.g. DERIVATION_TEMPLATE.md), keeping SKILL.md as an overview that links one level deep.
De-duplicate Step 7's 'derivation package must include' bullet list against the 'Required File Structure' code block so the canonical structure lives in one place.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's intelligence, but the terminal 'Key Rules' section restates workflow content (separate identity/proposition/approximation, keep one invariant object, mark uncertainty) and the 'Required File Structure' template overlaps Step 7's 'must include' list. | 2 / 3 |
Actionability | Instruction-only yet highly actionable: exact target file (DERIVATION_PACKAGE.md), explicit STATUS values, a fill-in document template, and concrete step classifications (identity/proposition/approximation/interpretation). | 3 / 3 |
Workflow Clarity | An explicit 8-step sequence culminates in a 'Final Verification' checklist, with a feedback loop that downgrades to a blocker report when the derivation cannot be made coherent honestly. | 3 / 3 |
Progressive Disclosure | Sections are clearly organized, but the skill is a ~270-line monolithic file with no external references, and content that could be split (the file-structure template, output modes) is inline; the under-50-line exception does not apply. | 2 / 3 |
Total | 10 / 12 Passed |