Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality, comprehensive testing guide that provides excellent actionable guidance with executable templates, clear workflows for diagnosing and fixing test failures, and good progressive disclosure. Its main weakness is moderate verbosity — the 'Is It the Test or the Code?' section, while valuable, could be condensed without losing utility. Overall, it serves as an effective reference that respects Claude's intelligence while providing the project-specific conventions and patterns that Claude genuinely needs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is generally well-structured and avoids explaining basic concepts like what Jest is, but it's quite long (~200+ lines). Some sections like the 'Is It the Test or the Code?' diagnostic table, while useful, are somewhat verbose and include guidance Claude could largely infer. The decision rules and question tables add value but could be tighter. | 2 / 3 |
Actionability | Excellent actionability throughout. Provides complete, executable test templates for unit, integration, and MCP tool tests with real code patterns. Commands are copy-paste ready (e.g., `npx jest ... --no-coverage`), mock patterns are concrete with actual require paths, and the nock HTTP interception example is fully executable. | 3 / 3 |
Workflow Clarity | Multi-step workflows are clearly sequenced with validation checkpoints. The 'Examining Failing Tests' section provides a clear diagnostic sequence (run in isolation → read failure → check common causes → use --verbose). The 'Is It the Test or the Code?' section provides an explicit decision framework with feedback loops (revert → re-run → decide). The fixing section addresses specific failure modes with concrete remediation steps. | 3 / 3 |
Progressive Disclosure | Content is well-organized with clear sections progressing from project layout → running → writing → debugging → fixing → coverage. The 'Additional Reference' section at the bottom provides one-level-deep links to fixtures, configs, and CI workflow. Content is appropriately inline for a single SKILL.md without needing separate files given the scope. | 3 / 3 |
Total | 11 / 12 Passed |