Individual skill
code-simplifier
Code simplification skill for improving clarity, consistency, and maintainability while preserving exact behavior. Use when simplifying code, reducing complexity, cleaning up recent changes, applying refactoring patterns, or improving readability. Triggers on tasks involving code cleanup, simplification, refactoring, or readability improvements.
skills/.curated/code-simplifier/SKILL.md
Source commit cf93c57cac89d6fc3e4194686000411567f5caf3
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- Yes
- Observed behavior
- Not checked yet
- Last checked
- Nov 5, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 222
- Repository last updated
- Aug 15, 2026
- License
- MIT
Observed agent integration: codex
- engineering Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
AGENTS.mddoc · 113,363 bytesREADME.mddoc · 4,078 bytesSKILL.mdcore · 8,464 bytesassets/templates/_template.mddoc · 1,081 bytesmetadata.jsonasset · 922 bytesreferences/_sections.mddoc · 1,954 bytesreferences/behave-no-semantics-change.mddoc · 3,171 bytesreferences/behave-preserve-api.mddoc · 2,437 bytesreferences/behave-preserve-errors.mddoc · 2,440 bytesreferences/behave-preserve-outputs.mddoc · 1,889 bytesreferences/behave-preserve-side-effects.mddoc · 3,081 bytesreferences/behave-verify-before-commit.mddoc · 2,845 bytesreferences/ctx-detect-lint-config.mddoc · 1,576 bytesreferences/ctx-follow-existing-patterns.mddoc · 2,016 bytesreferences/ctx-project-over-generic.mddoc · 2,233 bytesreferences/ctx-read-claude-md.mddoc · 1,622 bytesreferences/dead-delete-not-comment.mddoc · 3,796 bytesreferences/dead-keep-why-comments.mddoc · 4,405 bytesreferences/dead-remove-obvious-comments.mddoc · 3,952 bytesreferences/dead-remove-todo-fixme.mddoc · 4,293 bytesreferences/dead-remove-unused.mddoc · 3,846 bytesreferences/dup-avoid-over-abstraction.mddoc · 5,433 bytesreferences/dup-data-driven.mddoc · 5,677 bytesreferences/dup-extract-for-clarity.mddoc · 5,146 bytesreferences/dup-no-single-use-helpers.mddoc · 4,668 bytesreferences/dup-rule-of-three.mddoc · 3,653 bytesreferences/flow-boolean-simplification.mddoc · 3,516 bytesreferences/flow-early-return.mddoc · 2,833 bytesreferences/flow-explicit-over-dense.mddoc · 3,868 bytesreferences/flow-flatten-nesting.mddoc · 5,502 bytesreferences/flow-guard-clauses.mddoc · 4,245 bytesreferences/flow-no-nested-ternaries.mddoc · 3,343 bytesreferences/flow-optional-chaining.mddoc · 2,563 bytesreferences/flow-positive-conditions.mddoc · 4,186 bytesreferences/flow-single-responsibility.mddoc · 5,894 bytesreferences/idiom-go-error-handling.mddoc · 3,112 bytesreferences/idiom-prefer-language-builtins.mddoc · 4,181 bytesreferences/idiom-python-comprehensions.mddoc · 2,572 bytesreferences/idiom-rust-iterator-chains.mddoc · 3,022 bytesreferences/idiom-rust-question-mark.mddoc · 2,505 bytesreferences/idiom-ts-const-assertions.mddoc · 2,083 bytesreferences/idiom-ts-strict-types.mddoc · 1,966 bytesreferences/name-avoid-abbreviations.mddoc · 4,048 bytesreferences/name-avoid-generic.mddoc · 4,723 bytesreferences/name-consistent-vocabulary.mddoc · 4,158 bytesreferences/name-intention-revealing.mddoc · 2,698 bytesreferences/name-nouns-for-data.mddoc · 3,495 bytesreferences/name-string-interpolation.mddoc · 3,480 bytesreferences/scope-minimal-diff.mddoc · 3,141 bytesreferences/scope-no-global-rewrites.mddoc · 3,403 bytesreferences/scope-no-unrelated-refactors.mddoc · 3,011 bytesreferences/scope-recent-code-only.mddoc · 3,088 bytesreferences/scope-respect-boundaries.mddoc · 3,443 bytes
Read excerpt
# Community Code Simplification Best Practices
Comprehensive code simplification guide for AI agents and LLMs. Contains 47 rules across 8 categories, prioritized by impact from critical (context discovery, behavior preservation) to incremental (language idioms). Each rule includes detailed explanations, real-world examples comparing incorrect vs. correct implementations, and specific impact metrics.
## Core Principles
1. **Context First**: Understand project conventions before making any changes
2. **Behavior Preservation**: Change how code is written, never what it does
3. **Scope Discipline**: Focus on recently modified code, keep diffs small
4. **Clarity Over Brevity**: Explicit, readable code beats clever one-liners
## When to Apply
Reference these guidelines when: