Agent skill

Code Simplification

by HangYu8123 in HangYu8123/mini-harness

Simplify code for clarity while preserving exact behavior — reduce nesting, split long functions, remove redundancy and dead code, and fix unclear names.

No licenceAuto-check passedDevelopment

Install Code Simplification

skills CLI
$ npx skills add HangYu8123/mini-harness --skill code-simplification -a claude-code

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

GitHub CLI
$ gh skill install HangYu8123/mini-harness code-simplification --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/HangYu8123/mini-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/code-simplification .claude/skills/code-simplification && 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-simplification
GitHub stars
199
Token cost
~1.2k tokens
SKILL.md length
682 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
None found

At a glance

Simplify code for clarity while preserving exact behavior — reduce nesting, split long functions, remove redundancy and dead code, and fix unclear names.

  • Works in 6 steps: Preserve behavior exactly. Same output… → Understand before touching (Chesterton's… → Match the project's conventions, not… → …
  • Tasks that involve Code simplification
  • SKILL.md covers Your job, Intake, Rules and What to look for, plus 2 more sections
  • Calls git

What it does

Code Simplification is an agent skill from HangYu8123/mini-harness. Simplify code for clarity while preserving exact behavior — reduce nesting, split long functions, remove redundancy and dead code, and fix unclear names. TRIGGER: invoked by a mini-harness skill's review stage when the dial simplify=local is set. Not a planning-time skill.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Code simplification. The repository describes itself as: A local minimized harness, with simplified output and logs for self-evolve.

When your agent uses it

  • Tasks that involve Code simplification

Example prompts

  • “/code-simplification”

Workflow steps

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

  1. Preserve behavior exactly. Same output for every input, same error behavior, same side
  2. Understand before touching (Chesterton's Fence). Know what the code is responsible for,
  3. Match the project's conventions, not your preferences — imports, naming, error handling,
  4. Comprehension speed is the goal, not line count. A one-line nested ternary is not simpler
  5. Don't over-simplify. Inlining a helper that gave a concept its name, merging two simple
  6. One change at a time. Apply, re-run the tests, keep or revert. Batching untested edits

What it can do on your machine

Read from SKILL.md and the folder at commit baa821f. 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 Simplification loads about 1.2k tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 682 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~1.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

Without a licence we can't republish the file, so here is its outline and opening line. It has 682 words (~1,225 tokens).

“The platform-independent alternative to Claude Code's native /simplify. An mh-* skill's review stage spawns the implementer with this file when the dial simplify=local is set — see .harness/harness.md §5 for how it is launched.”

— opening of SKILL.md by HangYu8123
name
code-simplification
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/code-simplification of HangYu8123/mini-harness.

Open the folder on GitHubat commit baa821f

Compare with similar skills

Code Simplification 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 Simplification compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Code Simplification this skillHangYu8123/mini-harness199—~1.2kAutomated safety check: PassNone
PonytailDavidObando/gsharp5648 repos~1.7kAutomated safety check: PassMIT
Ponytail Reviewkortix-ai/suna20k4 repos~593Automated safety check: PassCustom licence
Code Simplification for ego-litecitrolabs/ego-lite17k—~1.2kAutomated safety check: PassMIT
Refactor Pass for Simplicitystar-history/star-history9.6k1 repos~168Automated safety check: PassMIT
RTK Rust Code Simplifierrtk-ai/rtk83k—~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • Ponytail

    DavidObando/gsharp

    Forces the laziest solution that actually works, simplest, shortest, most minimal.

    564 GitHub starsUsed in 8 repos~1.7k tokens
    DevelopmentAuto-check passed
  • Ponytail Review

    kortix-ai/suna

    Code review focused exclusively on over-engineering. An agent skill from kortix-ai/suna.

    20k GitHub starsUsed in 4 repos~593 tokens
    DevelopmentAuto-check passed
  • Finds and implements evidence-backed simplifications in the ego-lite repository, such as dead code, duplicated state and speculative abstractions, without hiding behavior changes.

    17k GitHub stars~1.2k tokensUpdated 14 days ago
    DevelopmentAuto-check passed
  • Refactor Pass for Simplicity

    star-history/star-history

    Perform a refactor pass focused on simplicity after recent changes. Use when the user asks for a refactor/cleanup pass, simplification, or dead-code removal…

    9.6k GitHub starsUsed in 1 repo~168 tokens
    DevelopmentAuto-check passed
  • Reviews RTK's Rust code for over-engineering and verbose patterns, applying idioms like iterator chains and early returns while protecting a specific list of constraints from being simplified away.

    83k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Deslop

    millionco/react-doctor

    Simplify and refine recently modified code while preserving functionality.

    15k GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed

More from HangYu8123/mini-harness

All 8 skills in this repo
  • Breakdown PR

    HangYu8123/mini-harness

    Plan and optionally execute a large pull request split into small stacked PRs.

    199 GitHub stars~2.8k tokensUpdated 15 days ago
    Auto-check passed
  • Code Review And Quality

    HangYu8123/mini-harness

    Multi-axis, review-only code review of a diff across six axes — request achievement, correctness, readability/simplicity, architecture, security, and performance — with severity-labelled findings.

    199 GitHub stars~1.8k tokensUpdated 15 days ago
    Auto-check passed
  • Mh Init

    HangYu8123/mini-harness

    mini-harness · initialize or re-initialize a repo's memory under .harness/repoinfo/ with a multi-agent pass — three-perspective codebase overview, ranked scripts map, issue scan, git-seeded update…

    199 GitHub stars~2.6k tokensUpdated 15 days ago
    Auto-check passed
  • Mh Loop

    HangYu8123/mini-harness

    mini-harness · repeat a pass toward a verifiable goal until a check passes or a safety stop fires — spec → validate → confirm → loop (pass · observe · exit check · ledger) → review → record.

    199 GitHub stars~2.8k tokensUpdated 15 days ago
    Auto-check passed
  • Mh Wiki

    HangYu8123/mini-harness

    mini-harness · consolidate execution trajectories (.harness/exectraj/) into repoinfo/harnesseffect.md — which parts of the harness helped or hurt, root causes, and one proposed change at a time.

    199 GitHub stars~1.6k tokensUpdated 15 days ago
    Auto-check passed
  • Mini Harness

    HangYu8123/mini-harness

    mini-harness · a supplementary layer over Claude Code and Codex — tags the task, runs online-researcher / diversifier / devils-advocate in addition to the native flow when a trigger fires, keeps a…

    199 GitHub stars~1.4k tokensUpdated 15 days ago
    Auto-check passed

Categories

Questions about Code Simplification

What does Code Simplification do?

Simplify code for clarity while preserving exact behavior — reduce nesting, split long functions, remove redundancy and dead code, and fix unclear names. Code Simplification is an agent skill from HangYu8123/mini-harness. Simplify code for clarity while preserving exact behavior — reduce nesting, split long functions, remove redundancy and dead code, and fix unclear names.

When should I use Code Simplification?

Code Simplification fits situations like: tasks that involve Code simplification.

How do I install Code Simplification in Claude Code?

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

How do I install Code Simplification in Codex?

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

Can I use Code Simplification 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 HangYu8123/mini-harness --skill code-simplification -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-simplification, .gemini/skills/code-simplification, .github/skills/code-simplification and .opencode/skills/code-simplification in your project.

What does Code Simplification need to run?

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

Does Code Simplification 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 Simplification 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 Simplification use?

No licence was found for Code Simplification or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Code Simplification use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Code Simplification?

Skills that share tags, products or a category with Code Simplification: Ponytail (DavidObando/gsharp, 564 stars), Ponytail Review (kortix-ai/suna, 20k stars), Code Simplification for ego-lite (citrolabs/ego-lite, 17k stars) and Refactor Pass for Simplicity (star-history/star-history, 9.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Code Simplification?

HangYu8123 (a GitHub user) maintains it in HangYu8123/mini-harness, which has 199 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on September 22, 2026.

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