Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A dense, actionable skill body with executable code, concrete gate rules, and well-structured one-level references. Its only weakness is mild verbosity - the Overview readme-quote and a converter-tool list repeated across three sections could be trimmed.
Suggestions
Collapse the repeated converter-tool lists (py2lcov/xml2lcov/nyc/gcov) into a single mention in 'When to use' and refer back to it from 'How to use' rather than re-listing.
Trim the Overview's verbatim lcov-readme quote about geninfo/lcov/genhtml; Claude already knows these utilities, so keep only the 'lingua franca' point that justifies the skill.
The CI snippet in references/format-diff-and-ci.md invokes scripts/parse_lcov.py and scripts/coverage_gate.py, but no scripts/ bundle exists - either add the scripts or note that parse_lcov.py is the inline body snippet saved to that path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and high-signal, but the Overview quotes the lcov readme to explain geninfo/lcov/genhtml and the converter tool list (py2lcov/xml2lcov/nyc/gcov) is repeated across Overview, 'When to use', and 'How to use' - concepts and lists that could be tightened. | 2 / 3 |
Actionability | Provides a complete executable parse_lcov.py, a real `.info` worked example, concrete gate thresholds (N=0.5, M=5, 80%/70%), and an anti-patterns table with fixes - copy-paste ready guidance throughout. | 3 / 3 |
Workflow Clarity | The 'How to use' section gives a clear 4-step sequence (confirm emitter -> parse -> cache baseline & diff -> gate) with an explicit correctness checkpoint: 'recompute totals from the per-line records rather than trusting the summary fields'. | 3 / 3 |
Progressive Disclosure | SKILL.md is an overview that signals a single one-level-deep reference (references/format-diff-and-ci.md, verified present) for the full keyword table, diff+gate implementation, and CI wiring; content is appropriately split across well-organized sections. | 3 / 3 |
Total | 11 / 12 Passed |