Run any Skill in Manus with one click

complexity-audit

Stars0

Forks0

UpdatedJune 15, 2026 at 14:55

Deterministic, advisory complexity and maintainability audit for Python. Uses lizard (per-function cyclomatic complexity, length, parameters) and radon mi (per-module maintainability index) to emit SIMPLIFY / DECOMPOSE findings to the shared code-health finding schema. Never mutates source.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

jc1122

jc1122/repo-audit-skills

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software Quality Assurance Analysts and TestersComputer and Mathematical Occupations·SOC 15-1253

File Explorer

14 files

SKILL.md

readonly

name	complexity-audit
version	0.8.0
description	Deterministic, advisory complexity and maintainability audit for Python. Uses lizard (per-function cyclomatic complexity, length, parameters) and radon mi (per-module maintainability index) to emit SIMPLIFY / DECOMPOSE findings to the shared code-health finding schema. Never mutates source.

complexity-audit

Overview

Reports functions that are too complex or too long and modules with low maintainability. Advisory only; it does not refactor.

Quick Start

python3 scripts/complexity_audit.py \
  --root /path/to/repo \
  --source-prefix src/pkg/ \
  --out-dir /tmp/complexity

Output

complexity_findings.json — sorted list of findings (shared schema).
complexity_report.md — human-readable summary grouped by signal, including counted precision suppressions such as entrypoint_mi_relaxed.
stdout status JSON — includes status, findings, leaf, and entrypoint_mi_relaxed.

Exit Codes

0 — clean (no findings).
1 — advisory findings present.
2 — tool/config error (e.g. lizard or radon not installed).

Flags and Thresholds

--source-prefix is repeatable. Override thresholds with --config thresholds.json; see skills/complexity-audit/references/rubric.md.

Default thresholds include mi_low=65, mi_medium=50, and mi_entrypoint_low=20. Set "mi_entrypoint_low": null to disable entrypoint module-MI relaxation.

Notes

Findings are deterministic: identical input yields byte-identical complexity_findings.json.
CLI entrypoints with if __name__ == guards suppress module-level maintainability-index findings when MI is at least mi_entrypoint_low but below mi_low; each suppression increments entrypoint_mi_relaxed.
The entrypoint relaxation is intentionally narrow: standalone CLI modules can have low module MI because they remain self-contained, while function-level lizard checks still report actionable complexity. Entrypoint modules below the floor still emit maintainability_index.

Limits

Advisory only — emits SIMPLIFY/DECOMPOSE findings and never refactors or mutates source.
Python only: backed by lizard and radon mi, which analyze Python source.
Requires lizard and radon installed; a missing tool is a config error (exit 2), not a finding.
Metrics are static thresholds on cyclomatic complexity, length, parameter count, and maintainability index; they flag structural smells, not behavioral bugs, and need human interpretation.
No network access; deterministic for fixed inputs and tool versions.

More from this repository

same repository

test-effectiveness-audit

jc1122/repo-audit-skills

Deterministic, advisory mutation-testing audit for Python. Wraps mutmut==3.6.0 to measure per-module mutation kill rates, emitting TEST findings (shared code-health schema) for modules whose kill rate falls below the configured threshold. Never mutates source in-place; runs in a sandbox copy. The machine-readable answer to "how good are my tests at catching bugs?".

2026-06-160

code-health-audit-pipeline

jc1122/repo-audit-skills

Umbrella that runs the code-health leaf skills (complexity, duplication, dead-code, structure, quality) in parallel, merges and ranks their findings into one report, and emits a supervisor decision with exit codes 0/1/2. Reads a leaf registry so new language leaves plug in without changing the orchestrator. Advisory only.

2026-06-150

coverage-gap-audit

jc1122/repo-audit-skills

Deterministic, advisory testedness audit for Python. Consumes coverage.py JSON report(s) and emits TEST findings (shared code-health schema) for production files with no or insufficient test coverage. Never runs tests, never mutates source. The machine-readable answer to "is this file safe to refactor?".

2026-06-150

dead-code-audit

jc1122/repo-audit-skills

Deterministic, advisory dead-code audit for Python. Uses vulture (unused functions/classes/methods/properties) and ruff F401/F811/F841 (unused imports, redefinitions, unused locals) to emit DELETE findings to the shared code-health finding schema. Never mutates source.

2026-06-150

dependency-audit

jc1122/repo-audit-skills

Deterministic, advisory dependency audit for Python. Compiles declared dependencies (pyproject.toml [project] or requirements*.txt) against AST-collected imports and reports unused declarations, undeclared imports, test-only runtime usage, and optional C-8 advisory enrichment. Uses stdlib only, requires Python >=3.11, never mutates source, and never makes network calls.

2026-06-150

docs-consistency-audit

jc1122/repo-audit-skills

Deterministic, advisory docs-vs-reality audit for Python docs and command docs that emits LINT findings. Compares documented CLI flags against actual argparse parsers, checks doc paths for dead references, flags stale version pins, and optionally reports docstring coverage. Never mutates source.

2026-06-150

name	complexity-audit
version	0.8.0
description	Deterministic, advisory complexity and maintainability audit for Python. Uses lizard (per-function cyclomatic complexity, length, parameters) and radon mi (per-module maintainability index) to emit SIMPLIFY / DECOMPOSE findings to the shared code-health finding schema. Never mutates source.

complexity-audit

Overview

Reports functions that are too complex or too long and modules with low maintainability. Advisory only; it does not refactor.

Quick Start

python3 scripts/complexity_audit.py \
  --root /path/to/repo \
  --source-prefix src/pkg/ \
  --out-dir /tmp/complexity

Output

complexity_findings.json — sorted list of findings (shared schema).
complexity_report.md — human-readable summary grouped by signal, including counted precision suppressions such as entrypoint_mi_relaxed.
stdout status JSON — includes status, findings, leaf, and entrypoint_mi_relaxed.

Exit Codes

0 — clean (no findings).
1 — advisory findings present.
2 — tool/config error (e.g. lizard or radon not installed).

Flags and Thresholds

--source-prefix is repeatable. Override thresholds with --config thresholds.json; see skills/complexity-audit/references/rubric.md.

Default thresholds include mi_low=65, mi_medium=50, and mi_entrypoint_low=20. Set "mi_entrypoint_low": null to disable entrypoint module-MI relaxation.

Notes

Findings are deterministic: identical input yields byte-identical complexity_findings.json.
CLI entrypoints with if __name__ == guards suppress module-level maintainability-index findings when MI is at least mi_entrypoint_low but below mi_low; each suppression increments entrypoint_mi_relaxed.
The entrypoint relaxation is intentionally narrow: standalone CLI modules can have low module MI because they remain self-contained, while function-level lizard checks still report actionable complexity. Entrypoint modules below the floor still emit maintainability_index.

Limits

Advisory only — emits SIMPLIFY/DECOMPOSE findings and never refactors or mutates source.
Python only: backed by lizard and radon mi, which analyze Python source.
Requires lizard and radon installed; a missing tool is a config error (exit 2), not a finding.
Metrics are static thresholds on cyclomatic complexity, length, parameter count, and maintainability index; they flag structural smells, not behavioral bugs, and need human interpretation.
No network access; deterministic for fixed inputs and tool versions.