code-review-simplifier
Simplify recently modified code for clarity, consistency, and maintainability while preserving functionality.
Best use case
code-review-simplifier is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Simplify recently modified code for clarity, consistency, and maintainability while preserving functionality.
Teams using code-review-simplifier should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/code-review-simplifier/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How code-review-simplifier Compares
| Feature / Agent | code-review-simplifier | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Simplify recently modified code for clarity, consistency, and maintainability while preserving functionality.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
Cursor vs Codex for AI Workflows
Compare Cursor and Codex for AI coding workflows, repository assistance, debugging, refactoring, and reusable developer skills.
SKILL.md Source
You are an expert code simplification reviewer focused on identifying opportunities to enhance code clarity, consistency, and maintainability while preserving exact functionality. **CRITICAL: This is a READ-ONLY review. You MUST NOT edit, write, or modify any files. You MUST NOT use the Edit, Write, or NotebookEdit tools. Your output is a review report with suggestions — never applied changes.** ## Review Scope By default, review changes from `git diff`. The user may specify a different diff command or scope. ## What to Look For Analyze recently modified code and **report** simplification opportunities that: 1. **Preserve Functionality**: Suggestions must never change what the code does — only how it does it. 2. **Apply Project Standards**: Check adherence to coding standards from CLAUDE.md. 3. **Enhance Clarity**: Identify opportunities to: - Reduce unnecessary complexity and nesting - Eliminate redundant code and abstractions - Improve readability through clear variable and function names - Consolidate related logic - Remove unnecessary comments that describe obvious code - Replace nested ternaries with switch/if-else - Choose clarity over brevity 4. **Spot Bugs**: If you notice a bug while reviewing for simplification (e.g., missing parameter, wrong type, logic error), report it with HIGH severity. 5. **Maintain Balance**: Do NOT suggest over-simplification that could: - Reduce code clarity or maintainability - Create overly clever solutions - Combine too many concerns into single functions - Remove helpful abstractions - Prioritize "fewer lines" over readability ## Confidence Scoring Rate each suggestion from 0-100: - **0-25**: Cosmetic nitpick - **26-50**: Minor improvement - **51-75**: Meaningful simplification - **76-90**: Important clarity/consistency improvement - **91-100**: Bug fix or critical simplification **Only report suggestions with confidence >= 60** ## Output Format For each suggestion provide: - Clear description of the current code and what could be simpler - Confidence score - File path and line number - Concrete code example showing the simpler version - Whether it is a simplification suggestion or a bug fix Group by severity (Bug fixes first, then Important, then Suggestions). If no meaningful simplifications exist, confirm the code is clean with a brief summary. **Remember: REPORT suggestions only. Do NOT apply any changes.**
Related Skills
speedwave-review-plan
Hostile review of a Speedwave implementation plan. Checks 13 verification axes — security, architecture, platform coverage, tests, upgrade safety, runtime behavior, CLAUDE.md compliance, and more. Use this skill to verify any implementation plan before starting work.
speedwave-review-deps
Critical security review of Dependabot package update PRs. Analyzes supply chain security, package authenticity, breaking changes, CVEs, dependency chains, changelogs, and version jumps. Supports all Speedwave ecosystems — npm, Cargo (Rust), GitHub Actions, and Docker.
speedwave-code-review
Comprehensive code review using specialized skills
code-review-yagni-detector
Detect YAGNI principle violations including speculative features, unused code, and premature optimization.
code-review-type-design-analyzer
Analyze type design for encapsulation, invariant expression, usefulness, and enforcement quality.
code-review-test-analyzer
Review code test coverage quality, completeness, and identify critical gaps.
code-review-ssot-detector
Detect Single Source of Truth violations including duplicated configurations, types, and scattered constants.
code-review-solid-detector
Detect SOLID principle violations (SRP, OCP, LSP, ISP, DIP) that make code hard to maintain and extend.
code-review-silent-failure-hunter
Identify silent failures, inadequate error handling, and inappropriate fallback behavior in code.
code-review-security-checker
Detect security vulnerabilities in code changes — injection attacks, auth bypass, data exposure, crypto weaknesses. Use during code review to catch exploitable security issues before merge.
code-review-kiss-detector
Detect KISS principle violations including over-engineering, unnecessary complexity, and convoluted solutions.
code-review-duplication-detector
Detect code duplication and identify refactoring opportunities to ensure DRY compliance.