Code Simplifier
SkillDev toolsLets your agent clean up and simplify existing code without changing what it does.
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.
Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
Then ask your AI: use the Code Simplifier skill
About this skill
Simplify existing code for clarity and maintainability without changing behavior. Use when asked to clean up or simplify code, especially recent changes.
What this skill tells your AI
The instructions your AI receives, as published by feiskyer/codex-settings in skills/code-simplifier/SKILL.md and read by ahel’s review.
Make code easier to understand and maintain without changing what it does. Prefer readable, explicit code over compact or clever rewrites.
Scope and conventions
Use the user's named files or diff. Otherwise, focus on code touched in the current task or clearly identified recent changes; ask for a target if none is evident. Inspect surrounding code as needed without turning a local cleanup into a repository-wide refactor. For review-only requests, propose changes without editing.
Follow applicable project guidance, such as AGENTS.md or CLAUDE.md, and the conventions in nearby code. Derive import style, function syntax, type annotations, framework patterns, and error handling from that project rather than imposing a different style.
Refinement criteria
- Preserve observable behavior, including public interfaces, outputs, errors, side effects, and evaluation order. Treat bug fixes or behavior changes as separate work unless requested.
- Reduce unnecessary nesting, duplication, and indirection where doing so makes the logic easier to follow. Keep helpful abstractions and separate unrelated concerns.
- Improve names and remove comments that merely restate the code; retain comments that explain intent or non-obvious constraints.
- Prefer explicit branches over nested ternaries or dense one-liners when they obscure the logic. Fewer lines alone is not an improvement.
Completion
Finish the scoped cleanup and validate it using checks appropriate to the change and the repository's requirements. For non-obvious rewrites, check relevant edge cases against the original behavior. If behavioral equivalence remains unclear, retain the original form and explain the limitation.
Report significant refinements, checks run, and any remaining validation gaps. If no worthwhile simplification is found, say so without manufacturing edits.
Signals
- GitHub stars
- 244
- Forks
- 33
- Last commit
- Sep 2026
Advanced
- Item type
- skill
- Key
code-simplifier-feiskyer- Source
- github.com/feiskyer/codex-settings
github.com/feiskyer/codex-settings