🎯

code-simplifier

🎯Skill

from carvalab/k-skills

What it does

Simplifies code for enhanced readability and maintainability by refining recently modified files while preserving exact functionality.

📦

Part of

carvalab/k-skills(9 items)

code-simplifier

Installation

📋 No install commands found in docs. Showing default command. Check GitHub for actual instructions.

Quick InstallInstall with npx

npx skills add carvalab/k-skills --skill code-simplifier

Need more details? View full documentation on GitHub →

6Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Code simplification for clarity and maintainability. Use PROACTIVELY after code is written or modified to refine recently changed files.

Overview

# Code Simplifier

Enhance code clarity, consistency, and maintainability while preserving exact functionality. Apply project-specific best practices without altering behavior. Prioritize readable, explicit code over compact solutions.

> Related Skills:

> - kavak-documentation - Query for Kavak coding standards and patterns before simplifying

> - Use kavak-platform/plati_query MCP tool to verify Kavak-specific idioms

Workflow

1. Discover Project Standards

Locate project configuration files (in priority order):

.claude/CLAUDE.md, CLAUDE.md (root)
.cursor/rules/.md, .cursor/rules/.mdc, .cursorrules
AGENTS.md, .github/copilot-instructions.md
.editorconfig, .prettierrc, .eslintrc.*

Extract coding standards and patterns. If none exist, apply general best practices.

2. Identify Target Code

Default: Recently modified files (git diff, git status)
Explicit: Files or directories specified by user
Broad: When instructed to review entire modules

3. Apply Refinements

Preserve Functionality

Never change what the code does, only how
Run existing tests to verify no regressions

Apply Project Standards

Follow discovered conventions
Match existing code style
Respect established patterns

Enhance Clarity

Reduce complexity and nesting
Eliminate redundant code
Use clear variable/function names
Avoid nested ternaries - use switch or if/else
Choose clarity over brevity

Maintain Balance

Don't create overly clever solutions
Don't combine too many concerns
Don't remove helpful abstractions
Three similar lines > premature abstraction

4. Verify

Functionality unchanged
Code is simpler and maintainable
Run linters/formatters if configured

Guidelines

Operate autonomously after code is written/modified
Don't add features or make "improvements" beyond simplification
Don't add docstrings/comments to unchanged code
Trust internal code and framework guarantees

References

| Reference | Purpose |

| ----------------------------- | ------------------------------ |

| references/patterns.md | Common simplification patterns |

| references/anti-patterns.md | Code smells to refactor |

| references/examples.md | Before/after examples |

More from this repository8

🎯

refactor-cleaner🎯Skill

refactor-cleaner skill from carvalab/k-skills

🎯

code-review🎯Skill

Performs comprehensive senior-level code review, focusing on complex logic and architecture while delegating style checks to automated tools.

🎯

doc-updater🎯Skill

doc-updater skill from carvalab/k-skills

🎯

test-driven-development🎯Skill

Guides developers through test-driven development by enforcing the Red-Green-Refactor cycle, ensuring tests drive code design and prevent common testing pitfalls.

🎯

backend-development🎯Skill

Proactively builds robust backend APIs using Node.js/TypeScript and Go, applying Clean Architecture and software design principles for scalable microservices.

🎯

frontend-development🎯Skill

Develops Next.js applications using TypeScript, Server Components, and Server Actions, optimizing for performance and minimal client-side JavaScript.

🎯

skill-creator🎯Skill

Guides developers in creating concise, task-focused agent skills using progressive disclosure and a 3-tier loading architecture.

🎯

kavak-documentation🎯Skill

Skill