CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

lizard-complexity

Use when a multi-language codebase needs one complexity gate, or a function has grown unreviewable and CI needs a number. Runs Lizard (30+ languages) on production code to enforce per-function cyclomatic complexity, length and parameter-count thresholds, excluding tests.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is testland/lizard-complexity

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is strong: third-person voice, explicit 'Use when' triggers with concrete scenarios, and a specific statement of what the tool enforces and on what scope. Its only weakness is that it undersells the CI integration and output-format capabilities (CSV/XML/HTML, fail-on-threshold) that the skill body delivers, leaving coverage slightly incomplete and a few natural trigger synonyms unused.

DimensionReasoningScore

Specificity

"Runs Lizard (30+ languages) on production code to enforce per-function cyclomatic complexity, length and parameter-count thresholds, excluding tests" names several concrete actions (CCN, length, parameter-count thresholds, test exclusion). It stops short of comprehensive coverage — the CI output formats and fail-on-warning behavior that make up half the skill are absent, so it fits anchor 4 rather than 5.

4 / 5

Completeness

It explicitly answers both: "Use when a multi-language codebase needs one complexity gate, or a function has grown unreviewable and CI needs a number" (when, with concrete trigger phrases) and "Runs Lizard (30+ languages) ... to enforce per-function cyclomatic complexity, length and parameter-count thresholds" (what). This matches anchor 5; anchor 4's 'when could be more explicit' does not apply since the when clause gives three specific triggering scenarios.

5 / 5

Trigger Term Quality

Natural user phrases like "needs one complexity gate", "a function has grown unreviewable", "CI needs a number", and "cyclomatic complexity" are present and would plausibly be said by developers. A few common variants ("CCN", "code complexity", "function too long") are missing, matching anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — a Lizard-based per-function cyclomatic-complexity gate on production code excluding tests — with clear triggers unlikely to fire for unrelated skills. The body even explicitly hands off cognitive complexity to a separate sonarqube skill, confirming minimal conflict risk (anchor 5).

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

testland/qa

Path

plugins/qa-code-quality/skills/lizard-complexity/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.