Content
81%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 highly actionable, well-sequenced testing skill: concrete commands, templates, validation gates, and a genuine fix-loop feedback cycle, with bundle references properly structured one level deep. Its main weaknesses are token weight from inlined project-process ceremony and cross-references that depend on files outside this skill's bundle.
Suggestions
Trim the process overhead: move the pre-phase-0 branch/GitHub-integration steps and handoff-ritual commit details into the referenced team-workflow.md and keep only a one-line pointer plus the testing-specific deltas in SKILL.md.
Remove the trailing '## Keywords' section — the frontmatter description already carries the trigger terms, making the body section redundant.
Consolidate the verify-gate language (currently split between the 'MANDATORY: Verify gate language' section and fix-loop Step 4) into a single stated gate to save tokens without losing the rule.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core testing guidance is lean, but the ~330-line body carries heavy process ceremony (pre-phase-0 GitHub integration commands, four-part handoff ritual, backlog writeback rules) plus redundancy (verify-gate language restated, trailing Keywords section). Fits the 'mostly efficient but could be tightened' anchor rather than the verbose level below, since nothing explains concepts Claude already knows. | 3 / 5 |
Actionability | Fully executable guidance throughout: exact commands ('python3 tools/github-integration/flow.py tag-phase --item <ID> --phase test'), a copy-paste TEST-RESULT-BLOCK template, an A/B/C/D user decision prompt, a canonical commit message, and concrete coverage/naming tables. Common cases are covered with no meaningful gaps. | 5 / 5 |
Workflow Clarity | The fix-loop is a clearly sequenced 5-step process with an explicit feedback loop ('If failures remain, return to Step 1'), hard validation thresholds ('0 test failures, 0 lint errors', coverage not regressed), and a verify gate that forbids stale evidence ('Cached output and stale logs are not evidence'). Matches the anchor with explicit validation steps and error recovery. | 5 / 5 |
Progressive Disclosure | Bundle references (references/test-checklist.md, references/test-anti-patterns.md) exist, are one level deep, and are clearly signaled via the 'Full version / Short version' pattern. Falls short of 5 because many cross-references point outside the skill's bundle (skills/project-conventions/..., coding/SKILL.md, _devprocess/...) and the pre-phase-0/handoff process detail arguably belongs in the shared team-workflow reference rather than inlined here. | 4 / 5 |
Total | 17 / 20 Passed |