Content
63%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 TDD skill with strong executable examples and a clear sequenced workflow including validation checkpoints. Its main weaknesses are verbosity (restate-the-obvious lists and large inlined reference blocks) and a monolithic single-file structure that underuses progressive disclosure.
Suggestions
Trim the 'ベストプラクティス' (best practices) and '成功指標' (success metrics) lists, which restate TDD fundamentals Claude already knows, to recover context budget.
Move the full mock-example blocks (Supabase/Redis/OpenAI) and the lengthy Playwright E2E specs into a separate references file linked from the body, keeping only one concise example inline.
Add an explicit error-recovery feedback loop to step 6 (refactor) and step 7 (coverage) — e.g., 'if coverage < 80%, identify untested paths and add tests before re-running' — to strengthen validation checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Noticeably verbose at ~400 lines: the 10-item 'best practices' list, success-metrics list, and restated core principles restate TDD concepts Claude already knows, and the three large mock examples plus full E2E specs pad the context considerably. | 2 / 5 |
Actionability | Provides copy-paste ready executable examples throughout: concrete Jest/Vitest unit tests, API integration tests, full Playwright E2E specs, mock setups, and exact bash commands (npm test, npm run test:coverage). | 5 / 5 |
Workflow Clarity | The 7-step TDD workflow is clearly sequenced with validation checkpoints (run tests expecting failure, re-run expecting success, verify 80% coverage), but error-recovery feedback loops are only lightly sketched rather than explicit. | 4 / 5 |
Progressive Disclosure | Content is well-sectioned but entirely monolithic in a single file with no bundle files; large reference-style blocks (mock patterns, full E2E specs, coverage config) are inlined where a one-level reference would reduce load, and no external navigation is signaled. | 3 / 5 |
Total | 14 / 20 Passed |