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.
An exemplary instruction-style skill body: highly actionable with exact paths, flags, and option tables; a gated six-step workflow with explicit batch validation and retry loops; and clean progressive disclosure where every reference resolves to a real, well-organized bundle file. The only weakness is minor — a couple of duplicated runtime-substitution caveats that could be consolidated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, table-driven content with no explanations of concepts Claude already knows, but a few trimmable redundancies: the runtime-substitution caveat is stated twice ("Concrete AskUserQuestion references below are examples — substitute the local equivalent" and "Tool names above are examples; use the local equivalent in other runtimes") and backend selection is restated in Step 5.2. Fits anchor 4 (efficient, minor instances that could be trimmed); not 5 because not every token earns its place. | 4 / 5 |
Actionability | Provides exact, executable guidance throughout: file patterns ("prompts/NN-{type}-[slug].md"), concrete flag syntax ("--type infographic --style vector-illustration --palette macaron", "--preset edu-visual", "--ref <files...>"), resolved EXTEND.md paths with fallback order, a specific AskUserQuestion option table, and an output-path table. As an instruction-only skill, the guidance is copy-paste-ready and covers the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps with a checklist, explicit hard gates ("⛔ BLOCKING", "Do not start Step 4 or later until the user completes Step 3"), batch validation ("Never start a batch until all its prompt files exist on disk"), and an error-recovery feedback loop ("Retry failed items once without regenerating successful ones"). The batch-operation validation requirement is satisfied, matching anchor 5. | 5 / 5 |
Progressive Disclosure | The body is a genuine overview with well-signaled, one-level-deep references — all 8 referenced files exist in the bundle — and even includes conditional-loading guidance ("Load references/codex-imagegen.md only for this branch"). The styles.md → styles/*.md second level is an organized gallery fan-out rather than a buried chain, matching anchor 5 (clear overview, easy navigation). | 5 / 5 |
Total | 19 / 20 Passed |