Content
85%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 well-structured skill body: executable quick commands with expected results, a checkpointed workflow with stop-if guards, and clean one-level-deep progressive disclosure into real bundle files. The only weakness is length in the anti-patterns section, where two entries explain downstream tooling behavior in depth that would sit better in a reference file.
Suggestions
Compress the two anti-patterns about empty list fields and `blocked-by` lifecycle semantics to a few lines each, moving the `context-ready.sh` fail-closed explanation into typologies.md or cli.md behind a load-when signal.
Trim the repeated "Expected result" prose in Quick Commands to a single line per command where the outcome is already evident from the command.
The `context-index` skill is referenced twice but never introduced; one clause stating the relationship (or a reference entry) would let readers skip it without losing the thread.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The Quick Commands and Workflow sections are dense and earn their tokens, but the two anti-patterns on empty lists and `blocked-by` lifecycles spend roughly 50 lines explaining downstream `context-ready.sh` semantics that could be tightened or moved to a reference. Mostly efficient with some unnecessary explanation — anchor 3, above anchor 2 because there is no filler or explanation of concepts Claude already knows. | 3 / 5 |
Actionability | Six copy-paste-ready bash commands cover the common cases (tags, related links, blocked-by, heredoc body, dry-run, new typology), each paired with an explicit "Expected result" line so success is checkable. Fully executable with specific examples — anchor 5. | 5 / 5 |
Workflow Clarity | The four-step workflow carries an explicit checkpoint on every step: a duplicate check with expected output (step 2), "Verify: the printed path uses the expected typology plus date" (step 3), and "Stop if" guards on steps 1 and 4. Not anchor 4 because no checkpoint is merely implicit or missing; the file-creation operation is low-risk so the absence of an explicit fix-and-retry loop is not a gap. | 5 / 5 |
Progressive Disclosure | The References section lists typologies.md, cli.md, and the frontmatter JSON schema, each with a "load when…" signal; all three files exist in the bundle and are one level deep with no chained references, and the bulk material (full CLI table, typology catalog, schema) correctly lives outside the body. Clear overview with well-signaled one-level-deep references — anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |