jacksonemmerich/farmapub / .agents/skills/code-simplifier
code-simplifier
VerifiedDetect and simplify overly complex code. Apply KISS principle - less is more.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
SKILL.md
View on GitHub---
name: code-simplifier
description: "Detect and simplify overly complex code. Apply KISS principle - less is more."
autoInvoke: true
priority: high
triggers:
- "simplify"
- "too complex"
- "make simpler"
- "reduce complexity"
- "KISS"
- "over-engineered"
---
# 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
| Signal | Action |
|--------|--------|
| Deep nesting (>3 levels) | Flatten with early returns |
| Long function (>30 lines) | Extract smaller functions |
| Complex conditionals | Use lookup tables |
| Over-abstraction | Inline single-use code |
| Premature optimization | Remove unless profiled |
---
## Complexity Targets
| Metric | Target |
|--------|--------|
| 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
| Command | Purpose |
|---------|---------|
| `simplify <file>` | Analyze and simplify a file |
| `simplify:check` | Check complexity metrics |
| `quality:complexity` | Full 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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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 implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |