Content
92%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 high-quality SKILL.md body: fully executable guidance organized as a sequenced framework-selection + setup workflow with explicit validation checkpoints and a verified, well-signaled one-level-deep reference bundle. The only trimmable fat is the trivial first-test and basic-mocking examples that restate what Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and leans on non-obvious gotchas (Jest 27+ `testEnvironment` default change, `vi.mock` hoisting leaking `undefined`, bare `vitest` hanging CI), but the trivial `sum.test.js` first-test examples and basic `jest.fn()` usage restate knowledge Claude already has and could be trimmed - minor over-explanation rather than a fully lean body. | 4 / 5 |
Actionability | Every section is copy-paste executable: exact install commands, complete annotated `jest.config.js` and `defineConfig` configs, package.json script blocks, CI YAML with specific flags (`--ci`, `--maxWorkers=2`, `--reporter=junit`), and a worked `jest.mock` example - fully covering the common cases. | 5 / 5 |
Workflow Clarity | Steps 1-6 are clearly sequenced behind a decision procedure ("Detect the framework, never assume... If two frameworks' signals coexist, stop and ask") and include explicit validation checkpoints (coverage-threshold gating that fails the run, `vitest run --typecheck`, `--ci` failing on missing snapshots) plus an anti-patterns table mapping each failure mode to its fix. | 5 / 5 |
Progressive Disclosure | The three bundle references (mocha.md, legacy-migration.md, jest-coverage.md) are real, substantive, one level deep with no nested references, and each is signaled with an explicit consultation condition (e.g., "maintaining a Mocha codebase → references/mocha.md"); deep material is delegated while the core lifecycle stays inline, and navigation via headers and links is easy. | 5 / 5 |
Total | 19 / 20 Passed |