Content
86%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, disciplined instruction-only skill: highly actionable rules with exact thresholds, named anti-patterns, and a concrete output contract, supported by a well-structured one-level-deep reference bundle for its specialized modes. The only weaknesses are minor: a few trimmable rhetorical flourishes and slight ambiguity in where the validation and simplicity gates sit relative to the approval gate.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative rule-writing that assumes Claude's competence — no concept explanations, exact thresholds ("More than 8 files", "3 or more genuinely different approaches"), and compact tables. Minor trimming opportunities exist: rhetorical flourishes ("A plan with placeholders is a promise to plan later", "discards the iterations someone else already paid for") and repeated approval-gate phrasing across Lightweight, Propose, Simplicity Gate, and Output sections. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: exact numeric thresholds, named forbidden placeholder strings ("TBD, TODO, 'implement later,' 'similar to step N'"), a concrete output template with named fields (Building / Not building / Approach / Key decisions / Unknowns), and literal user phrases that authorize implementation ("Implement the plan", "直接做", "按你说的来"). Specific examples cover the common cases; no pseudocode vagueness. | 5 / 5 |
Workflow Clarity | The pipeline is coherent with explicit checkpoints and feedback loops — "Get approval before proceeding", "If an unknown blocks a decision, loop back before approval", "If an attack holds, deform the design to survive it", and the Validate Before Handing Off checklist. Not 5 because the placement is slightly ambiguous: "Get approval before proceeding" closes Propose Approaches, yet the later Simplicity Gate says to shrink the plan "before asking for approval", leaving the ordering of validation/gating versus the approval gate to be inferred. | 4 / 5 |
Progressive Disclosure | Three bundle files exist (references/durable-context.md, mode-evaluation.md, mode-triage.md), each referenced exactly once in the body with a clear activation trigger ("For value, viability, commercialization, or keep/remove judgments..., load references/mode-evaluation.md"; "For a bundle of independently accepted or rejected asks..., load references/mode-triage.md"), and each is one level deep with no nested references. Mode-specific detail is appropriately split out while the core workflow stays in SKILL.md. | 5 / 5 |
Total | 18 / 20 Passed |