Content
86%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, rule-dense instruction skill that practices what it preaches on token efficiency and structure, with concrete commands and validation via CI. Its gaps are the absence of a worked example and a numbered workflow for its own primary task, both of which it requires of the skills it governs.
Suggestions
Add a short worked example (e.g., a 3-4 line model SKILL.md frontmatter and body skeleton) to raise actionability to fully copy-paste ready guidance.
Include a brief numbered workflow with decision gates for the main task (draft -> move dense facts to REFERENCE.md -> run skills:gen -> check) so the primary process is sequenced like the generated-facts flow already is.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is a rule, a limit, or a command ('Frontmatter: name, description...', 'Stay under 100 lines', 'npm run skills:gen'), with zero concept explanations or padding. This matches the lean-and-efficient anchor; level 4 would require at least minor over-explanation to trim, which is absent. | 5 / 5 |
Actionability | Guidance is mostly executable: concrete frontmatter fields, a required body order, hard limits, and runnable commands ('Edit the source, then run npm run skills:gen'). It stops short of level 5 because it never shows a worked example of a well-formed SKILL.md even though it mandates 'Quick start (one concrete example)' for the skills it governs. | 4 / 5 |
Workflow Clarity | The generated-facts flow is clearly sequenced with a validation backstop ('Edit the source, then run npm run skills:gen. CI runs npm run skills:check and fails on drift') and a closing Checklist acts as verification. It misses level 5 because the primary writing/updating task itself has no numbered workflow or decision gates of the kind the skill prescribes for others. | 4 / 5 |
Progressive Disclosure | The body is under 50 lines, well-organized into clear sections, and needs no external references; mentioned files (REFERENCE.md, EXAMPLES.md, TROUBLESHOOTING.md) are one level deep and clearly signaled. Per the simple-skill scoring note, this merits a 5 on organization alone. | 5 / 5 |
Total | 18 / 20 Passed |