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 well-structured TDD workflow skill with an exemplary RED/GREEN/REFACTOR sequence, explicit validation checkpoints, a feedback loop for stalled progress, and concrete good/bad code examples. Its main weaknesses are minor: a placeholder identifier in the flagship example, unstated dependencies on environment-specific tooling, and a few trimmable annotation lines.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean with phase sections, tight checklists, and no concept explanations Claude already knows, but the example annotations ('this is a STRONG sign that this is testing something real') and the embedded system-reminder aside are minor over-explanation that could be trimmed. It sits between 'efficient' (4) and 'every token earns its place' (5), closer to 4. | 4 / 5 |
Actionability | Provides executable bash commands ('npm test path/to/test.test.ts'), complete TypeScript test and implementation examples with good/bad contrasts, and concrete confirm-checklists. Minor gaps keep it below 5: the RED example calls 'foobar.retryOperation' as a placeholder, and steps depend on environment-specific tooling ('nori-task-runner', '.agency/plugins/nori/...') whose availability is unstated. | 4 / 5 |
Workflow Clarity | A 7-step numbered sequence (RED → test-quality evaluation → verify fail → GREEN → verify pass → refactor → verify pass) with explicit validation checkpoints at steps 3, 5, and 7, per-phase confirm checklists ('Test fails (not errors)', 'Failure message is expected'), and an error-recovery feedback loop ('If you go through three loops without making progress, switch to... creating-debug-tests-and-iterating'). This matches the anchor for clear sequence with explicit validation and feedback loops. | 5 / 5 |
Progressive Disclosure | No bundle files exist, so the skill is a single self-contained file with clear phase sections (RED, Verify RED, GREEN, Verify GREEN, REFACTOR) and one clearly signaled one-level-deep fallback reference to the nori debug skill. It exceeds 50 lines, so the simple-skill 5 exception does not apply, but structure and placement are good — matching the anchor for good structure with minor organization gaps. | 4 / 5 |
Total | 17 / 20 Passed |