Content
82%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.
This is a high-quality, execution-focused skill: every step ships runnable commands with concrete threshold values, defaults are documented, and the anti-patterns and limitations sections add genuine judgment rather than filler. The main gaps are minor — no error-recovery loop after a threshold breach in CI, slight repetition around the Lizard README reference, and no bundle files to offload the longer reference material.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — flag tables, one-line explanations, no padding explaining what cyclomatic complexity is. Minor trims exist: "per the [Lizard README]" is repeated, the intro re-lists languages already covered by the description, and default values are stated both in prose and in the flag table (anchor 4, not the fully lean anchor 5). | 4 / 5 |
Actionability | Every step gives copy-paste-ready commands (pip install, lizard src/ with concrete -x/-C/-L/-a values, --csv/-X/-H outputs, an exit-code-driven CI snippet, -l language scoping), and the anti-patterns table pairs each failure mode with a specific fix. This matches anchor 5's fully executable, common-case-covering guidance; the only soft spot ("run the standalone script: python lizard.py" without saying where lizard.py comes from) is mitigated by the linked repo. | 5 / 5 |
Workflow Clarity | Steps 1–6 are clearly sequenced from install to CI enforcement, and Step 5 includes an explicit exit-code checkpoint ("EXIT=$?; if [ \"$EXIT\" -ne 0 ]..."), which is real validation. It falls short of anchor 5 because there is no feedback loop for what to do after a breach — no guidance on identifying the offending functions from the report and re-scanning — though the read-only analysis means the destructive/batch cap does not apply. | 4 / 5 |
Progressive Disclosure | The single file is well-organized with purposeful sections (When to use, numbered steps, Anti-patterns, Limitations, References) and one clearly signaled, one-level-deep external reference. It is a ~120-line skill rather than the under-50-line case that can score 5 on sections alone, and content like the per-language scoping or anti-patterns table could live in reference files, so anchor 4 fits better than 5. | 4 / 5 |
Total | 17 / 20 Passed |