Content
73%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured testing skill with excellent workflow clarity, particularly the fix-loop with explicit validation gates and the verify gate language preventing premature completion claims. The main weakness is that it's heavily laden with project-specific process (branch management, GitHub integration, artifact triage, handoff rituals) that inflates the document beyond what's needed for testing guidance. Adding concrete test code examples would significantly improve actionability.
Suggestions
Add 1-2 concrete, executable test code examples (e.g., a sample unit test following AAA pattern and a sample integration test) to improve actionability from 4 to 5.
Consider moving the mandatory Pre-Phase 0 (branch/item check), Phase 0 (artifact triage), and Handoff Ritual sections to a shared workflow reference file, since they appear to be cross-cutting process concerns rather than testing-specific guidance — this would significantly improve conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains a significant amount of process overhead (branch checks, artifact triage, handoff rituals, GitHub integration commands) that may be project-specific workflow rather than testing-specific knowledge. The core testing guidance (AAA, FIRST, mocking rules) is reasonably concise, but the mandatory phases and handoff ritual add substantial length. Some sections like the unit test and integration test rules are efficient, but the overall document is bloated with process ceremony. | 3 / 5 |
Actionability | The skill provides concrete commands (python3 tools/github-integration/flow.py), specific patterns (AAA, FIRST), clear fix-loop steps with template output blocks, and actionable checklists. However, it lacks executable test code examples — no actual test file snippets showing what a generated test should look like. The fix-loop workflow and TEST-RESULT-BLOCK template are highly actionable. | 4 / 5 |
Workflow Clarity | The workflow is exceptionally well-sequenced with mandatory phases (Pre-Phase 0 → Phase 0 → analysis → test creation → fix-loop → handoff). The fix-loop includes explicit validation (run tests → summarize → ask user → fix → re-test → repeat until green), feedback loops for error recovery, and a clear gate condition ('0 test failures, 0 lint errors'). The verify gate language section explicitly forbids completion claims without fresh evidence. | 5 / 5 |
Progressive Disclosure | The skill references several external files (references/test-checklist.md, references/test-anti-patterns.md, skills/project-conventions/references/team-workflow.md, etc.) with clear signaling ('Full version: references/test-anti-patterns.md. Short version: ...'). The inline content provides short summaries while pointing to detailed references. However, no bundle files were provided to verify these references exist, and some references like coding/SKILL.md are cross-skill dependencies that add navigational complexity. | 4 / 5 |
Total | 16 / 20 Passed |