Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured orchestrator skill: actionable commands, a clearly sequenced workflow with real validation checkpoints, and clean progressive disclosure to existing reference and script files. The only weakness is mild redundancy between the Scripts and Record-the-result sections that could be tightened.
Suggestions
De-duplicate the record-diagnosis.js invocation and outcome narration: describe the command once in Scripts and have Record-the-result reference it by name rather than restating the full flags.
Trim restated rules in the body that already appear in 'Non-negotiable rules' (e.g. the 'Never increase a timeout' / 'one green run is not proof' points resurface in Reproduce and fix) to single cross-references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and assumes Claude's competence (no explaining what e2e tests or flakes are), but the record-diagnosis invocations and outcome narration are repeated near-verbatim across the Scripts and Record-the-result sections, which could be tightened. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready commands with concrete flags ('node .../triage-history.js --test-key ... --lookback-days 14'), a real failure-mode table with a Seen-on column, and an explicit outcome-to-command mapping. | 3 / 3 |
Workflow Clarity | Clear multi-stage sequence (Start/resume, Investigate, Root cause, Reproduce/fix, Record) with explicit validation checkpoints and feedback loops — checkpoint.js refuses phase=done until an outcome is set, 'Zero runs is never a clean result,' and the RED-bar and read-the-summary-first guards. | 3 / 3 |
Progressive Disclosure | SKILL.md is a concise overview pointing to five real, one-level-deep reference files (history-query, prior-triage, evidence-escalation, diagnosis-block, reproduction), each linked at the exact stage that needs it, with deterministic work split into scripts/ — no nested references and easy navigation. | 3 / 3 |
Total | 11 / 12 Passed |