Content
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill functions as a scripted walkthrough coordinator that delegates real work to 7+ unbundled external skills while padding the content with verbose narration templates. The phase sequence is logical but the skill suffers from being simultaneously too verbose (scripted dialogue, concept explanations) and too vague (actual implementation delegated to missing references). It would benefit significantly from trimming narration, bundling referenced skills, and adding concrete validation checkpoints between phases.
Suggestions
Cut the scripted narration blocks to 1-line summaries — Claude can generate contextually appropriate dialogue without verbatim scripts, saving ~40% of token budget.
Bundle or inline the key referenced skills (sdd-propose, sdd-spec, sdd-design format requirements at minimum) so the skill is self-contained enough to execute.
Add explicit validation checkpoints between phases (e.g., 'Verify proposal.md exists and contains required sections before proceeding to Phase 4') and specify recovery actions when sdd-verify reports FAILING verdicts.
Extract the Phase 10 summary template and the onboarding change criteria into a referenced file to reduce the monolithic structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~180 lines. It includes extensive narration templates that Claude doesn't need spelled out verbatim, explains obvious concepts ('Each scenario is a potential test case'), and repeats the SDD cycle concept multiple times. The quoted narration blocks are particularly wasteful — Claude can generate contextually appropriate narration without scripted dialogue. | 1 / 3 |
Actionability | The skill provides a clear 10-phase sequence with specific criteria (e.g., the onboarding change criteria tree is useful), but relies heavily on references to other skills (sdd-explore, sdd-propose, sdd-spec, etc.) without providing their content or concrete implementation details. The actual 'how' is delegated to external skills that aren't bundled, making this more of a coordination script than executable guidance. | 2 / 3 |
Workflow Clarity | The 10-phase sequence is clearly ordered and includes a checkpoint at Phase 3 ('ask before continuing past proposal'). However, validation/error handling is weak — the 'if anything blocks, STOP and explain' rule is vague, there are no explicit verification steps between phases, and the verify phase itself just says 'run sdd-verify behavior' without specifying what to do if verification fails beyond the archive step. | 2 / 3 |
Progressive Disclosure | The skill references 7+ external skills (sdd-explore, sdd-propose, sdd-spec, sdd-design, sdd-tasks, sdd-apply, sdd-verify, sdd-archive) and a shared file (sdd-phase-common.md) but none are bundled. The entire content is monolithic — all 10 phases are inline with verbose narration templates that could be separated. There's no clear navigation structure for the referenced materials. | 1 / 3 |
Total | 6 / 12 Passed |