Agent skill

Simplify

by tellahq in tellahq/opensession

Clean up the changed code without changing behavior — review the diff for reuse, simplification, efficiency, and altitude cleanups via 4 parallel agents, then apply the fixes

MITAuto-check passedAgent Workflows

Install Simplify

skills CLI
$ npx skills add tellahq/opensession --skill simplify -a claude-code

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

GitHub CLI
$ gh skill install tellahq/opensession simplify --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/tellahq/opensession.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/simplify .claude/skills/simplify && 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
simplify
GitHub stars
392
Token cost
~834 tokens
SKILL.md length
486 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Clean up the changed code without changing behavior — review the diff for reuse, simplification, efficiency, and altitude cleanups via 4 parallel agents, then apply the fixes

  • Works in 3 steps: Establish the diff → Review (4 cleanup agents in parallel) → Apply the fixes
  • Tasks that involve Subagents
  • SKILL.md covers Phase 0 — Establish the diff, Phase 1 — Review (4 cleanup… and Phase 2 — Apply the fixes
  • Calls git

What it does

Simplify is an agent skill from tellahq/opensession. Clean up the changed code without changing behavior — review the diff for reuse, simplification, efficiency, and altitude cleanups via 4 parallel agents, then apply the fixes

Its SKILL.md is about 830 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 Agent Workflows, covering Subagents and Code review. It works with Git. The licence is MIT.

When your agent uses it

  • Tasks that involve Subagents
  • Tasks that involve Code review

Example prompts

  • “/simplify”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Establish the diff
  2. Review (4 cleanup agents in parallel)
  3. Apply the fixes

What it can do on your machine

Read from SKILL.md and the folder at commit b7d90b6. 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

Simplify loads about 834 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 486 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~834

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 tellahq/opensession at commit b7d90b6, republished under its MIT licence (© tellahq). 486 words, ~834 tokens.

Download SKILL.mdSave it as .claude/skills/simplify/SKILL.md (or your agent's skills folder).
name
simplify
description
Clean up the changed code without changing behavior — review the diff for reuse, simplification, efficiency, and altitude cleanups via 4 parallel agents, then apply the fixes
argument-hint
[<target>] (defaults to the current diff)

Simplify

/simplify → 4 cleanup agents in parallel → apply the fixes

You are improving the quality of the changed code, not hunting for bugs. Review it for reuse, simplification, efficiency, and altitude issues, then fix what you find. Do not look for correctness bugs — that is what a code review is for.

Phase 0 — Establish the diff

If $ARGUMENTS names a target (a path, a commit, a ref range, a PR number), treat it as scope guidance and establish the diff from it. Otherwise review the current change:

  • Working-tree changes: git diff HEAD (plus git status --short for new files).
  • If the working tree is clean, the branch's committed diff: git diff @{upstream}...HEAD, falling back to git diff origin/main...HEAD when there is no upstream.

Read the diff, and read enough of each enclosing function or file to judge the change in context. If the diff is empty, say so and stop.

Phase 1 — Review (4 cleanup agents in parallel)

Launch 4 independent review agents via the task tool (subagent_type: "explore"), all in a single message so they run concurrently. Pass each agent the diff, the files it touches, and exactly one of the four angles below. Each returns its findings with file, line, a one-line summary, and the concrete cost (what is duplicated, wasted, or harder to maintain).

Reuse

Flag places the diff re-implements something the codebase already has — grep shared/utility modules and files adjacent to the change, and name the existing helper to call instead.

Simplification

Flag unnecessary complexity the diff adds: redundant or derivable state, copy-paste with slight variation, deep nesting, dead code left behind. Name the simpler form that does the same job.

Show full SKILL.md (211 more words)Show less
Efficiency

Flag wasted work the diff introduces: redundant computation or repeated I/O, independent operations run sequentially, blocking work added to startup or hot paths. Also flag long-lived objects built from closures or captured environments — they keep the entire enclosing scope alive for the object's lifetime (a memory leak when that scope holds large values); prefer a class/struct that copies only the fields it needs. Name the cheaper alternative.

Altitude

Check that each change is implemented at the right depth, not as a fragile bandaid. Special cases layered on shared infrastructure are a sign the fix isn't deep enough — prefer generalizing the underlying mechanism over adding special cases.

Phase 2 — Apply the fixes

Wait for all four agents to complete, dedup findings that point at the same line or mechanism, and fix each remaining one directly. Skip any finding whose fix would change intended behavior, require changes well outside the reviewed diff, or that you judge to be a false positive — note the skip rather than arguing with it. Finish with a brief summary of what was fixed and what was skipped (or confirm the code was already clean).

Behavior must not change. If a cleanup is only safe alongside a behavior change, don't make it — report it as a suggestion instead.

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

Files

Just SKILL.md in .agents/skills/simplify of tellahq/opensession.

Open the folder on GitHubat commit b7d90b6

Compare with similar skills

Simplify 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.

Simplify compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Simplify this skilltellahq/opensession392—~834Automated safety check: PassMIT
O2 Review Loopopenobserve/openobserve22k—~3.7kAutomated safety check: PassAGPL-3.0
Clawteamwin4r/ClawTeam-OpenClaw1.5k—~3.1kAutomated safety check: PassMIT
Cursor Composer Task DelegateChachamaru127/claude-code-harness3.2k—~4.4kAutomated safety check: NotesMIT
Ad ReviewCorridorTech/PoseCap224—~2.4kAutomated safety check: NotesApache-2.0
Workflow Code ReviewdavidYichengWei/agentic-engineering-framework158—~1.1kAutomated safety check: PassMIT

Similar skills

  • O2 Review Loop

    openobserve/openobserve

    Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.

    22k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Clawteam

    win4r/ClawTeam-OpenClaw

    Multi-agent swarm orchestration. An agent skill from win4r/ClawTeam-OpenClaw.

    1.5k GitHub stars~3.1k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Cursor Composer Task Delegate

    Chachamaru127/claude-code-harness

    Hands one implementation task to Cursor Composer in an isolated git worktree, then reviews its diff and cherry-picks the result into the main branch.

    3.2k GitHub stars~4.4k tokensUpdated 4 days ago
    DevelopmentAuto-check: notes
  • Ad Review

    CorridorTech/PoseCap

    Two-axis fresh-context code review per WORKFLOW §10. An agent skill from CorridorTech/PoseCap.

    224 GitHub stars~2.4k tokensUpdated 2 days ago
    DevelopmentAuto-check: notes
  • Workflow Code Review

    davidYichengWei/agentic-engineering-framework

    代码评审。协调 5 个专项 reviewer subagent 对代码进行并行多维度审查。可由用户直接触发,也可由主 agent 加载后作为 Judge 执行。

    158 GitHub stars~1.1k tokensUpdated 6 mo ago
    DevelopmentAuto-check passed
  • Subagent Review

    NikiforovAll/claude-code-rules

    Review changed code for reuse, quality, and efficiency using three parallel disposable subagents.

    141 GitHub stars~927 tokensUpdated 7 days ago
    DevelopmentAuto-check passed

More from tellahq/opensession

All 15 skills in this repo
  • Effect TS

    tellahq/opensession

    Write idiomatic Effect v4 TypeScript verified against the pinned effect@4.0.0-rc.112 source.

    392 GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Reflect

    tellahq/opensession

    Spawn three parallel review child sessions over the active transcript, surface learnings, and route each to a concrete edit on an existing skill.

    392 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Show Me

    tellahq/opensession

    Help the user understand the current topic visually with concise diagrams, code-shape sketches, and focused HTML artifacts.

    392 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Automate Me

    tellahq/opensession

    A skill your agent uses for "automate me", "create/update/refresh my -mode skill", "turn/capture my preferences or working style into a skill", or wanting agents to follow how the user works.

    392 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • PR Autofix

    tellahq/opensession

    Auto-fix a PR — address ALL reviewers' open feedback + failing CI, push, and reply in each addressed thread with honest attribution

    392 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Swarm

    tellahq/opensession

    Fan out N parallel workers, drain them, and return one report.

    392 GitHub stars~609 tokensUpdated today
    Auto-check passed

Works with

Questions about Simplify

What does Simplify do?

Clean up the changed code without changing behavior — review the diff for reuse, simplification, efficiency, and altitude cleanups via 4 parallel agents, then apply the fixes. Simplify is an agent skill from tellahq/opensession.

When should I use Simplify?

Simplify fits situations like: tasks that involve Subagents; tasks that involve Code review.

How do I install Simplify in Claude Code?

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

How do I install Simplify in Codex?

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

Can I use Simplify 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 tellahq/opensession --skill simplify -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/simplify, .gemini/skills/simplify, .github/skills/simplify and .opencode/skills/simplify in your project.

What does Simplify need to run?

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

Does Simplify 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 Simplify 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 Simplify use?

Simplify 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 Simplify use?

About 834 tokens (SKILL.md is roughly 3.3k 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 Simplify?

Skills that share tags, products or a category with Simplify: O2 Review Loop (openobserve/openobserve, 22k stars), Clawteam (win4r/ClawTeam-OpenClaw, 1.5k stars), Cursor Composer Task Delegate (Chachamaru127/claude-code-harness, 3.2k stars) and Ad Review (CorridorTech/PoseCap, 224 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Simplify?

tellahq (a GitHub organization) maintains it in tellahq/opensession, which has 392 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 9, 2026.

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