Content
96%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 orchestration skill: deterministic stages are given exact commands with inputs, outputs, skip conditions, and validation feedback loops, while the sole intelligence-requiring stage is delegated to a sibling skill. The only structural improvement would be moving the key-files table and Stage 9 audit detail into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean for a nine-stage pipeline: each stage gets a copy-paste command, one or two sentences of purpose, and explicit input/output paths, with no explanations of concepts Claude already knows. Tables (scenario-to-stage, key files) are dense and pull their weight, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Every stage has an executable command (npm run capture/generate/build/test/...), concrete file paths (packages/sdk/generated/tools-manifest.json, scripts/ir-schema.ts), and defined inputs/outputs. The scenario table maps real situations to exact starting stages, making the guidance fully copy-paste ready. | 5 / 5 |
Workflow Clarity | The nine stages are explicitly sequenced, with dedicated validation stages (unit, script, E2E, lock validation), an explicit feedback loop ('If this fails with a projection error, go back to Stage 2 and fix domain-map.json'), a warning about Stage 8 ordering relative to Stage 3, and 'When to skip' conditions per stage. This matches the anchor requiring explicit validation steps and error-recovery loops. | 5 / 5 |
Progressive Disclosure | Structure is good: clear stage sections, a quick-reference section, and smart delegation of the only agent-judgment stage to the sibling stitch-sdk-domain-design skill. However, no bundle files exist and reference-like material (the 11-row key-files table and the detailed Stage 9 audit checklist) is inlined in a ~200-line body where a reference file would keep SKILL.md a purer overview, so it sits at 'good structure; minor organization gaps' rather than level 5. | 4 / 5 |
Total | 19 / 20 Passed |