Skip to content

jacksonemmerich/farmapub / .agents/skills/code-simplifier

code-simplifier

Unverified

Detect and simplify overly complex code. Apply KISS principle - less is more.

Skill: Code Simplifier

Category: Code Quality Version: 1.0.0 Rule Reference: rules/simplicity-over-complexity.md


Overview

Detect and simplify overly complex code. Apply KISS principle (Keep It Simple, Stupid).

Philosophy: The best code is code you don't have to write. Less is more.

Full Guide: Read rules/simplicity-over-complexity.md for comprehensive patterns and examples.


Quick Reference

SignalAction
Deep nesting (>3 levels)Flatten with early returns
Long function (>30 lines)Extract smaller functions
Complex conditionalsUse lookup tables
Over-abstractionInline single-use code
Premature optimizationRemove unless profiled

Complexity Targets

MetricTarget
Cyclomatic complexity≤10
Nesting depth≤3
Function length≤30 lines
File length≤300 lines
Parameters≤3

Simplification Checklist

Before writing or reviewing code, ask:

  1. Can I delete this? - Unused code, dead branches
  2. Can I inline this? - Single-use abstractions
  3. Can I flatten this? - Nested conditions, callbacks
  4. Can I use built-ins? - Array methods, standard library
  5. Is this needed now? - YAGNI (You Ain't Gonna Need It)
  6. Would a junior understand? - If not, simplify

Commands

CommandPurpose
simplify <file>Analyze and simplify a file
simplify:checkCheck complexity metrics
quality:complexityFull complexity report

Example Session

User: This function is too complex, simplify it

Claude: Let me analyze the complexity...

Complexity Analysis:
- Cyclomatic complexity: 15 (target: ≤10)
- Nesting depth: 5 (target: ≤3)
- Lines: 87 (target: ≤30)

Simplification Plan:
1. Convert nested ifs to early returns (-3 nesting)
2. Extract validation logic to separate function (-20 lines)
3. Replace switch with lookup table (-15 lines, -5 complexity)
4. Remove unused error handling branch

Applying changes...

Result:
- Cyclomatic complexity: 6 ✓
- Nesting depth: 2 ✓
- Lines: 28 ✓

Related Resources

  • Full KISS Guide: rules/simplicity-over-complexity.md
  • Complexity Command: commands/quality/complexity.md
  • Refactor Workflow: commands/refactor.md
  • Code Reviewer: skills/code-reviewer/SKILL.md

Remember: Simple code is not dumb code. It takes skill to write simple code.


Version: 1.0.0

receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 318kUpdated Claude CodeCodexUnverifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 318kUpdated Claude CodeCodexUnverifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 318kUpdated Claude CodeCodexUnverifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 318kUpdated Claude CodeCodexUnverifiedInstall