Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced instruction skill with strong feedback checkpoints, but it is long for a single file with some redundancy across its posture/rules sections and no progressive disclosure via reference files.
Suggestions
Consolidate the overlapping guidance in Operating Principles, Response Posture, Anti-Sycophancy Rules, and Pushback Patterns into a single section to remove redundancy and cut length.
Move the Six Forcing Questions (with red flags) and the design-doc templates into reference files under references/ and link to them one level deep, keeping SKILL.md as a lean overview.
Trim a few of the BAD/GOOD pushback dialogues to one representative example each while preserving the pattern.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and free of basic-concept filler, but at ~370 lines it repeats the same 'be specific / push hard' message across Operating Principles, Response Posture, Anti-Sycophancy Rules, and Pushback Patterns, and could be tightened. | 2 / 3 |
Actionability | Copy-paste-ready forcing questions, BAD/GOOD pushback scripts, mode-mapping tables, and full design-doc templates give concrete executable guidance rather than vague direction. | 3 / 3 |
Workflow Clarity | Phases 1-6 are explicitly sequenced with STOP checkpoints, a HARD GATE, premise confirm/loop-back feedback, and an Approve/Revise/Start-over gate, and no destructive/batch operations exist to require additional validation. | 3 / 3 |
Progressive Disclosure | Sections are well-organized by phase, but the skill is a single monolithic ~370-line file with no bundle references; the question bank, templates, and pushback patterns are inline content that could be split out. | 2 / 3 |
Total | 10 / 12 Passed |