Skill · #210 trending skills repo

Cyclomatic Complexity Skill

saurabhkumar8112/cyclomatic-complexity-skill

Claude skill: refactor code to reduce cyclomatic complexity

Stars: 407
This week: —
Forks: 9
Open issues: 0
Skills inside: 1

Get started

Install the skills

npx skills add saurabhkumar8112/cyclomatic-complexity-skill

Installs into Claude Code, Codex, Cursor, OpenCode and the other agents it finds on your machine.

/plugin marketplace add saurabhkumar8112/cyclomatic-complexity-skill
/plugin install cyclomatic-complexity@cyclomatic-complexity-skill

Run inside Claude Code, then pick what to install from /plugin.

git clone --depth 1 https://github.com/saurabhkumar8112/cyclomatic-complexity-skill.git /tmp/cyclomatic-complexity-skill
cp -r /tmp/cyclomatic-complexity-skill ~/.claude/skills/cyclomatic-complexity-skill

Claude Code reads ~/.claude/skills/ (or .claude/skills/ in a project). Other agents read the same SKILL.md format from their own skills folder.

Inside this repo

1 skill

cyclomatic-complexityRefactor code to reduce cyclomatic complexity so it stays readable, maintainable, and aligned with the long-term vision of the codebase, not just optimized for AI comprehension. Use whenever the user asks to refactor, simplify, clean up, or review code quality; mentions complexity, maintainability, skills/cyclomatic-complexity

Documentation

README

View on GitHub ↗

cyclomatic-complexity

A Claude skill that refactors code to reduce cyclomatic complexity. Built for AI-generated code: it works, but branches like a jungle. This skill makes Claude measure complexity, refactor hotspots, and keep code maintainable for humans and the long-term vision of the codebase.

What it does

Measures cyclomatic complexity per function (radon, eslint, gocyclo, lizard, or manual count)
Respects your project's own linter thresholds when configured
Refactors worst hotspots first: guard clauses, extract function, lookup tables, named predicates
Refuses to game the metric. Complexity moves into well-named functions, not into clever one-liners
Ends every refactor with a before/after complexity table

Install

Claude Code

/plugin marketplace add saurabhkumar8112/cyclomatic-complexity-skill
/plugin install cyclomatic-complexity@cyclomatic-complexity-skill

Claude.ai

Download the .skill file from Releases (or zip the skills/cyclomatic-complexity folder) and upload it under Settings → Capabilities → Skills.

Claude API

Upload via the Skills API.

Usage

Triggers automatically on refactoring, cleanup, and code review requests. Or invoke directly:

"Use the cyclomatic complexity skill to refactor parser.py"

Example output

## Complexity report
| Function | Before | After |
|----------|--------|-------|
| parseOrder | 14 | 4 |

Extracted: validateHeader, resolveDiscount
Behavior verified: existing test suite passes

License

Apache 2.0