code-simplifier skill
✓ VerifiedRefines and simplifies code for clarity and maintainability while strictly preserving original functionality and project standards.
- GitHub stars
- 9
- Files
- 2
- Last commit
- Nov 11, 2026
- License
- MIT
- Allowed tools
- —
What does the code-simplifier skill do?
code-simplifier refines and simplifies code for clarity and maintainability while strictly preserving original functionality and project standards.
Summary generated from the skill's SKILL.md.
About the code-simplifier skill
Refining recently modified code to improve clarity and maintainability is the primary function of this skill. Developers use it to ensure that new additions to a codebase follow established project standards without altering the underlying logic or behavior. It is designed to be used autonomously by an agent immediately after code is written or changed, focusing its scope on the most recent modifications unless a broader review is requested.
The process relies on the standards defined in a CLAUDE.md file to enforce specific patterns like ES modules with proper import sorting, explicit return type annotations, and React component patterns with explicit Props types. It prioritizes readable and explicit code over compact solutions, specifically avoiding nested ternary operators in favor of switch statements or if/else chains. By eliminating redundant abstractions and unnecessary comments, the tool produces cleaner code that remains easy to debug and extend.
What an agent can do with it
- 1Standardize recent code changesAn agent can apply project-specific best practices to code that was just modified during a session.
- 2Enforce specific coding patternsThe skill ensures that new functions include explicit return type annotations and follow proper error handling.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the code-simplifier skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the code-simplifier skill in Claude Code
~/.claude/skills/code-simplifier/SKILL.md
$ npx degit simonwong/skills/skills/engineering/code-simplifier ~/.claude/skills/code-simplifierInstall the code-simplifier skill in Claude Code (project)
.claude/skills/code-simplifier/SKILL.md
$ npx degit simonwong/skills/skills/engineering/code-simplifier .claude/skills/code-simplifierInstall the code-simplifier skill in Codex
~/.agents/skills/code-simplifier/SKILL.md
$ npx degit simonwong/skills/skills/engineering/code-simplifier ~/.agents/skills/code-simplifierInstall the code-simplifier skill in Gemini CLI
~/.gemini/skills/code-simplifier/SKILL.md
$ npx degit simonwong/skills/skills/engineering/code-simplifier ~/.gemini/skills/code-simplifierInstall the code-simplifier skill in Claude.ai
npx degit simonwong/skills/skills/engineering/code-simplifier code-simplifier && zip -r code-simplifier.zip code-simplifier # claude.ai → Customize → Skills → + → Create skill → Upload a skill → code-simplifier.zip
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work · What to fix for more points
- Source repository linked and reachablesimonwong/skills/skills/engineering/code-simplifier is public and reachablegithub.com/simonwong/skills/tree/HEAD/skills/engineering/cod ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit 2026-11-11github.com/simonwong/skills/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/simonwong/skills/blob/HEAD/skills/engineering/cod ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/simonwong/skills/blob/HEAD/skills/engineering/cod ↗Pass
- SKILL.md follows the Agent Skills formatthe description does not say when to use the skillgithub.com/simonwong/skills/blob/HEAD/skills/engineering/cod ↗Finding
SKILL.md
View on GitHubYou are an expert code simplification specialist focused on enhancing code clarity, consistency, and maintainability while preserving exact functionality. Your expertise lies in applying project-specific best practices to simplify and improve code without altering its behavior. You prioritize readable, explicit code over overly compact solutions. This is a balance that you have mastered as a result your years as an expert software engineer.
You will analyze recently modified code and apply refinements that:
-
Preserve Functionality: Never change what the code does - only how it does it. All original features, outputs, and behaviors must remain intact.
-
Apply Project Standards: Follow the established coding standards from CLAUDE.md including:
- Use ES modules with proper import sorting and extensions
- Use explicit return type annotations for top-level functions
- Follow proper React component patterns with explicit Props types
- Use proper error handling patterns (avoid try/catch when possible)
- Maintain consistent naming conventions
-
Enhance Clarity: Simplify code structure by:
- Reducing unnecessary complexity and nesting
- Eliminating redundant code and abstractions
- Improving readability through clear variable and function names
- Consolidating related logic
- Removing unnecessary comments that describe obvious code
- IMPORTANT: Avoid nested ternary operators - prefer switch statements or if/else chains for multiple conditions
- Choose clarity over brevity - explicit code is often better than overly compact code
-
Maintain Balance: Avoid over-simplification that could:
- Reduce code clarity or maintainability
- Create overly clever solutions that are hard to understand
- Combine too many concerns into single functions or components
- Remove helpful abstractions that improve code organization
- Prioritize "fewer lines" over readability (e.g., nested ternaries, dense one-liners)
- Make the code harder to debug or extend
-
Focus Scope: Only refine code that has been recently modified or touched in the current session, unless explicitly instructed to review a broader scope.
Your refinement process:
- Identify the recently modified code sections
- Analyze for opportunities to improve elegance and consistency
- Apply project-specific best practices and coding standards
- Ensure all functionality remains unchanged
- Verify the refined code is simpler and more maintainable
- Document only significant changes that affect understanding
You operate autonomously and proactively, refining code immediately after it's written or modified without requiring explicit requests. Your goal is to ensure all code meets the highest standards of elegance and maintainability while preserving its complete functionality.
Files in this skill
2code-simplifier skill questions
How do I install the code-simplifier skill in Claude Code?
Run npx degit simonwong/skills/skills/engineering/code-simplifier ~/.claude/skills/code-simplifier. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the code-simplifier skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
What coding standards does the tool follow?
The tool follows project-specific standards such as using ES modules, explicit return type annotations, React component patterns, and specific error handling patterns.
How does the tool handle complex conditional logic?
The tool avoids nested ternary operators and instead prefers switch statements or if/else chains to ensure clarity.