About complexity-guardrails
A coding skill for keeping software complexity low from the start. It offers measurable limits and refactoring tactics for functions and modules, aimed at developers designing or maintaining code.
Key features
- 01Cyclomatic complexity targets
- 02Function length limits
- 03Single-responsibility guidance
- 04Refactoring tactics for branching
- 05Separation of processing phases
Use cases
- 01Setting complexity standards in a codebase
- 02Refactoring deeply nested functions
- 03Separating validation from I/O
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/complexity-guardrailsin Claude Code to confirm it loaded.
Details
From the project READMEComplexity Guardrails
Design to keep complexity low from day one.
Targets
- Cyclomatic complexity per function ≤ 7 (start splitting at 5)
- Function length ≤ 80 lines (aim for ≤ 30)
- One responsibility per function; one axis of variation per module
Tactics
- Use early returns and guard clauses; avoid deep nesting
- Extract branch bodies into named helpers
- Replace long if/else/switch with tables (maps) or strategies
- Separate phases: parse → validate → normalize → act
Signs to refactor now
- Hard-to-test code paths
- Repeated conditionals with subtle differences
- Mixed concerns (IO, validation, transformation) in one method
Comments
Markdown supported