Content
92%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 strong, well-structured meta-skill: it provides an actionable six-step workflow with validation and feedback loops, copy-paste-ready commands backed by real bundle files, and clean progressive disclosure through one-level-deep, well-signaled references. The only room for improvement is trimming a few analogies and mildly repetitive passages.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and focused on non-obvious procedural guidance (frontmatter rules, degrees of freedom, packaging commands), with only minor over-explanation such as the 'narrow bridge with cliffs' analogy and slight repetition of directory purposes between the Anatomy section and Steps 3-4. It fits the 'efficient; minor instances of over-explanation that could be trimmed' anchor rather than the lean 'every token earns its place' level. | 4 / 5 |
Actionability | Guidance is fully executable: copy-paste ready commands ('npx tsx <SKILL_DIR>/scripts/init-skill.ts <skill-name> --path <output-directory>', packaging invocations), a complete frontmatter example with concrete naming rules (gerund form, 64/1024 char limits), and worked analysis examples. The referenced bundle files (references/workflows.md, references/output-patterns.md, and the three scripts) all exist, so the commands resolve to real resources. | 5 / 5 |
Workflow Clarity | The six-step creation process is clearly sequenced with explicit skip conditions per step, an automatic validation checkpoint during packaging, an explicit error-recovery feedback loop ('If validation fails... fix any validation errors and run the packaging command again'), and a test-before-ship rule for added scripts. This matches the top anchor for clear sequence with validation and feedback loops. | 5 / 5 |
Progressive Disclosure | SKILL.md stays within its own <500-line guidance (371 lines) and its two reference files exist, are exactly one level deep, and are clearly signaled with when-to-read guidance ('Multi-step processes: See references/workflows.md for sequential workflows and conditional logic'). Scripts are referenced with concrete usage commands. This matches the 'clear overview with well-signaled one-level-deep references' anchor. | 5 / 5 |
Total | 19 / 20 Passed |