Agent skill

Code Simplifier

by OpenHands in OpenHands/extensions

Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality.

MITAuto-check passedDevelopment

Install Code Simplifier

skills CLI
$ npx skills add OpenHands/extensions --skill code-simplifier -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OpenHands/extensions code-simplifier --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OpenHands/extensions.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/code-simplifier .claude/skills/code-simplifier && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
code-simplifier
GitHub stars
157
Token cost
~1.3k tokens
SKILL.md length
495 words
Files
9 (incl. references)
Skills in repo
78
Repo updated
First seen
Licence
MIT

At a glance

Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality.

  • Works in 3 steps: Code Reuse - Eliminate duplication,… → Code Quality - Improve naming, reduce… → Efficiency - Fix algorithmic issues,…
  • Asks to simplify code
  • SKILL.md covers Review Process, Guiding Philosophy, Consolidated Output Format and Reference Files
  • Calls git

What it does

Code Simplifier is an agent skill from OpenHands/extensions. Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Analyzes recently modified code across three dimensions - code reuse, code quality, and efficiency - and provides actionable improvement suggestions. This skill should be used when the user asks to "simplify code", "refine code", "clean up code", "improve code quality", or requests a simplification review of recent changes.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files (for example `.plugin/plugin.json`, `README.md` and `commands/simplify.md`).

It sits in Development, covering Code simplification, Code quality and Refactoring. The repository describes itself as: Public registry for OpenHands extensions. The licence is MIT.

When your agent uses it

  • Asks to simplify code
  • Improve code quality
  • Requests a simplification review of recent changes

Example prompts

  • “simplify code”
  • “refine code”
  • “clean up code”
  • “/code-simplifier”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Code Reuse - Eliminate duplication, consolidate shared logic, leverage existing utilities.
  2. Code Quality - Improve naming, reduce complexity, enforce project standards from AGENTS.md.
  3. Efficiency - Fix algorithmic issues, remove unnecessary work, optimize resource usage.

What it can do on your machine

Read from SKILL.md and the folder at commit d008b81. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Code Simplifier loads about 1.3k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 113 tokens; SKILL.md has 495 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~113
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenHands/extensions at commit d008b81, republished under its MIT licence (© OpenHands). 495 words, ~1,259 tokens.

Download SKILL.mdSave it as .claude/skills/code-simplifier/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
code-simplifier
description
Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Analyzes recently modified code across three dimensions - code reuse, code quality, and efficiency - and provides actionable improvement suggestions. This skill should be used when the user asks to "simplify code", "refine code", "clean up code", "improve code quality", or requests a simplification review of recent changes.
triggers
/simplify

Code Simplifier

Analyze recently modified code and suggest refinements that improve clarity, consistency, and maintainability - without changing what the code does. The review covers three complementary aspects:

  1. Code Reuse - Eliminate duplication, consolidate shared logic, leverage existing utilities.
  2. Code Quality - Improve naming, reduce complexity, enforce project standards from AGENTS.md.
  3. Efficiency - Fix algorithmic issues, remove unnecessary work, optimize resource usage.

Review Process

Identify the Scope

By default, focus on recently modified code. Use git diff or the file list from the current PR/MR to determine the changed files. When the user specifies a different scope, follow their instruction:

  • Specific files: "simplify src/auth.py" - review only the named files
  • Directory: "simplify the utils/ folder" - review all files in that directory
  • Full repo: "simplify the whole project" - review the entire codebase
  • PR/MR: "simplify this PR" - review only files changed in the current PR/MR
Sub-Agent Delegation (Preferred)

When sub-agent capability is available, delegate each review aspect to a separate sub-agent for parallel, focused analysis:

  1. Code Reuse Review Agent - Read references/code-reuse-review.md and analyze the changed files for duplication and consolidation opportunities.
  2. Code Quality Review Agent - Read references/code-quality-review.md and analyze the changed files for clarity, naming, complexity, and standards compliance.
  3. Efficiency Review Agent - Read references/efficiency-review.md and analyze the changed files for performance and resource usage issues.

Each sub-agent should:

  • Read the corresponding reference document for detailed criteria and output format
  • Read AGENTS.md at the repository root for project-specific coding conventions
  • Analyze only the recently changed code (unless instructed otherwise)
  • Return findings in the format specified by its reference document

After all sub-agents complete, synthesize their findings into a single consolidated report.

Sequential Review (Fallback)

When sub-agents are not available, perform all three reviews sequentially:

  1. Read references/code-reuse-review.md - review for duplication and reuse
  2. Read references/code-quality-review.md - review for clarity and standards
  3. Read references/efficiency-review.md - review for performance and resources

Apply the criteria and output format from each reference document.

Show full SKILL.md (179 more words)Show less

Guiding Philosophy

  • Preserve Functionality: Never change what the code does - only how it does it. All original features, outputs, and behaviors remain intact.
  • Follow Project Standards: Apply the coding conventions from AGENTS.md at the repository root (import ordering, naming, module structure, error handling, component patterns).
  • Clarity Over Brevity: Prefer explicit, readable code over compact one-liners. Avoid nested ternaries - use if/else or switch for multiple conditions.
  • Maintain Balance: Avoid over-simplification that reduces clarity, creates overly clever solutions, or combines too many concerns into a single function.
  • Pragmatism: Solve real problems, not imaginary ones. Do not optimize for theoretical edge cases or micro-benchmarks that do not matter at the project's scale.

Consolidated Output Format

Present the combined results from all three review aspects:

## Code Simplification Review

### Scope
[List of files reviewed and how scope was determined]

### Code Reuse
[Findings from the reuse review, using **[REUSE]** tags]

### Code Quality
[Findings from the quality review, using **[QUALITY]** tags]

### Efficiency
[Findings from the efficiency review, using **[EFFICIENCY]** tags]

### Summary
[Overall assessment: is the code in good shape, or does it need significant refinement?]
[Prioritized list of the most impactful changes to make first]

When a review aspect has no findings, include it with an explicit "no issues found" statement rather than omitting the section.

Reference Files

  • references/code-reuse-review.md - Detailed criteria for detecting duplication, consolidation opportunities, and over-abstraction
  • references/code-quality-review.md - Detailed criteria for naming, complexity, error handling, and project standards compliance
  • references/efficiency-review.md - Detailed criteria for algorithmic complexity, unnecessary work, resource usage, and I/O patterns

© OpenHands, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (references) in skills/code-simplifier of OpenHands/extensions.

  • SKILL.md
  • .claude-plugin
  • .codex-plugin
  • .plugin/plugin.json
  • README.md
  • commands/simplify.md
  • references/code-quality-review.md
  • references/code-reuse-review.md
  • references/efficiency-review.md

Open the folder on GitHubat commit d008b81

Compare with similar skills

Code Simplifier next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Code Simplifier compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Code Simplifier this skillOpenHands/extensions157—~1.3kAutomated safety check: PassMIT
Review And Simplify ChangesDimillian/Skills4k—~2kAutomated safety check: PassMIT
Codebase Health Refactoringkucherenko/jscpd6.3k—~2.5kAutomated safety check: PassMIT
DRY Refactoring With jscpdkucherenko/jscpd6.3k—~2.1kAutomated safety check: PassMIT
Code SimplifierTwiTech-LAB/devchain101—~2kAutomated safety check: PassCustom licence
Simplify Recent ChangesQwenLM/qwen-code28k—~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Review a git diff or explicit file scope for reuse, code quality, efficiency, clarity, and standards issues, then optionally apply safe Codex-driven fixes.

    4k GitHub stars~2k tokensUpdated 6 mo ago
    DevelopmentAuto-check passed
  • A three-part cleanup guided by jscpd: measure health, then fix duplicated code, remove dead code and simplify the most complex files, finishing by re-measuring the score.

    6.3k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Removes copy-paste duplication found by jscpd, starting with exact clones and hotspots, then renamed and near-miss copies, using proven refactoring strategies.

    6.3k GitHub stars~2.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Code Simplifier

    TwiTech-LAB/devchain

    Review a change set for reuse, simplification, efficiency, and altitude problems, then apply the fixes while preserving exact behavior.

    101 GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • Simplify Recent Changes

    QwenLM/qwen-code

    Reviews your uncommitted diff with three parallel passes for reuse, quality and efficiency, then applies the straightforward cleanups before a pull request.

    28k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Rnd Code Simplify

    chendongqi/OPB-Skills

    Expert code simplification and refactoring specialist that autonomously enhances code clarity, consistency, and maintainability while preserving exact functionality.

    125 GitHub stars~2.2k tokensUpdated 7 mo ago
    DevelopmentAuto-check passed

More from OpenHands/extensions

All 78 skills in this repo
  • Agent Readiness Report

    OpenHands/extensions

    Evaluate how well a codebase supports autonomous AI-assisted development.

    157 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Discord

    OpenHands/extensions

    Build and automate Discord integrations (bots, webhooks, slash commands, and REST API workflows).

    157 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • GitHub

    OpenHands/extensions

    Interact with GitHub repositories, pull requests, issues, and workflows using the GITHUBTOKEN environment variable and GitHub CLI.

    157 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • GitHub Issue To PR

    OpenHands/extensions

    Create an automation that implements GitHub issues when a configurable trigger label is applied.

    157 GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • GitHub Repo Monitor

    OpenHands/extensions

    This skill should be used when the user asks to "monitor a GitHub repository", "watch GitHub for issues or PRs", "respond to @OpenHands mentions on GitHub", "set up an OpenHands GitHub integration"…

    157 GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • GitLab Issue To Mr

    OpenHands/extensions

    Create an automation that implements GitLab issues when a configurable trigger label is applied.

    157 GitHub stars~4.9k tokensUpdated today
    Auto-check passed

Categories

Questions about Code Simplifier

What does Code Simplifier do?

Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Code Simplifier is an agent skill from OpenHands/extensions. Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality.

When should I use Code Simplifier?

Code Simplifier fits situations like: asks to simplify code; improve code quality; requests a simplification review of recent changes.

How do I install Code Simplifier in Claude Code?

Run `npx skills add OpenHands/extensions --skill code-simplifier -a claude-code`. Or copy the skill folder (skills/code-simplifier in OpenHands/extensions) into .claude/skills/code-simplifier in your project. Claude Code loads it when a task matches its description.

How do I install Code Simplifier in Codex?

Run `npx skills add OpenHands/extensions --skill code-simplifier -a codex`. Or copy the skill folder (skills/code-simplifier in OpenHands/extensions) into .agents/skills/code-simplifier in your project. Codex loads it when a task matches its description.

Can I use Code Simplifier in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenHands/extensions --skill code-simplifier -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/code-simplifier, .gemini/skills/code-simplifier, .github/skills/code-simplifier and .opencode/skills/code-simplifier in your project.

What does Code Simplifier need to run?

Going by SKILL.md and its folder, Code Simplifier needs the command-line tools its instructions call (git).

Does Code Simplifier access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Code Simplifier safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Code Simplifier use?

Code Simplifier is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Code Simplifier use?

About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.9k tokens, read only when the agent opens those files.

What are the alternatives to Code Simplifier?

Skills that share tags, products or a category with Code Simplifier: Review And Simplify Changes (Dimillian/Skills, 4k stars), Codebase Health Refactoring (kucherenko/jscpd, 6.3k stars), DRY Refactoring With jscpd (kucherenko/jscpd, 6.3k stars) and Code Simplifier (TwiTech-LAB/devchain, 101 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Code Simplifier?

OpenHands (a GitHub organization) maintains it in OpenHands/extensions, which has 157 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on October 6, 2026.

Source: OpenHands/extensions on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.