Content
77%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A thorough, highly actionable triage skill with a clear sequenced workflow and executable guidance. Its weaknesses are a monolithic structure with no progressive disclosure to separate reference files, and some conceptual prose in Step 5 that could be trimmed.
Suggestions
Split the tool-specific normalization tables (Step 1) and per-mutator heuristics (Step 3) into one-level-deep reference files linked from SKILL.md so the main file stays an overview.
Tighten Step 5 by reducing the academic prose on equivalent-mutant undecidability to a brief statement plus citation; Claude already knows the concept is undecidable.
Consider a short Quick-start block at the top summarizing the Step 1-to-5 flow before the detailed tables, so the entry point is scannable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Tool-specific normalization tables, per-mutator heuristics, and executable examples are high-value non-obvious detail, but Step 5's prose on equivalent-mutant undecidability re-explains a concept Claude already knows and could be tightened, so it is mostly efficient rather than lean. | 2 / 3 |
Actionability | Provides fully executable TypeScript interfaces and test blocks, concrete commands like 'mutmut run' / 'mutmut browse' / 'mutmut apply <mutant>', and specific separating inputs (e.g. 'qty === maxQty', 'tax === 0') plus a copy-paste output template - matching the copy-paste-ready anchor. | 3 / 3 |
Workflow Clarity | Steps 1-5 are explicitly sequenced with an ordered classification table and validation checkpoints ('If you cannot name one, the classification is equivalent-mutant') plus feedback loops ('Stabilize the covering test first, then re-run'), matching the clear-sequence-with-validation anchor. | 3 / 3 |
Progressive Disclosure | Well-organized into sections but it is a ~330-line monolith with no internal reference files (references/scripts/assets are absent), and tool-specific normalization tables and per-mutator detail that could be split out sit inline - matching the 'content that should be separate is inline' anchor rather than the one-level-deep-references anchor. | 2 / 3 |
Total | 10 / 12 Passed |