Agent skill

Claude Simplify Wrapper

by besimple-oss in besimple-oss/broccoli

Run Claude's built-in /simplify skill on BASESHA..HEAD, validate checks, and commit.

MITAuto-check passedDevelopment

Install Claude Simplify Wrapper

skills CLI
$ npx skills add besimple-oss/broccoli --skill claude-simplify-wrapper -a claude-code

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

GitHub CLI
$ gh skill install besimple-oss/broccoli claude-simplify-wrapper --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/besimple-oss/broccoli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/prompt-templates/skills/claude-simplify-wrapper .claude/skills/claude-simplify-wrapper && 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
claude-simplify-wrapper
GitHub stars
286
Token cost
~1.1k tokens
SKILL.md length
455 words
Files
3 (incl. scripts, references)
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Run Claude's built-in /simplify skill on BASESHA..HEAD, validate checks, and commit.

  • Works in 2 steps: Simplify subprocess — Invokes claude… → Validate+commit subprocess — A second…
  • Development work in your project
  • SKILL.md covers Preconditions, Scope / intent, Architecture and Expected runtime, plus 1 more section
  • Runs Python scripts from its folder; calls git and python3

What it does

Claude Simplify Wrapper is an agent skill from besimple-oss/broccoli. Run Claude's built-in /simplify skill on BASESHA..HEAD, validate checks, and commit.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/prompts/simplify-validator-system.md` and `scripts/run_simplify_loop.py`).

It sits in Development. It works with Git. The repository describes itself as: Broccoli turns Linear tickets into shipped PRs — powered by Claude and Codex, running on your own Google Cloud or Blaxel containers. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/claude-simplify-wrapper”

Requirements

  • Python 3

Workflow steps

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

  1. Simplify subprocess — Invokes claude with the /simplify prompt. The built-in skill handles its own three parallel agents and applies fixes…
  2. Validate+commit subprocess — A second claude subprocess that runs the repo's standard build/lint/test commands, fixes only breakages…

What it can do on your machine

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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • git
    • python3

    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

Claude Simplify Wrapper loads about 1.1k tokens when it runs, and up to ~1.5k if it reads all its reference files. Until then it costs about 27 tokens; SKILL.md has 455 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from besimple-oss/broccoli at commit 6cad3b9, republished under its MIT licence (© besimple-oss). 455 words, ~1,133 tokens.

Download SKILL.mdSave it as .claude/skills/claude-simplify-wrapper/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
claude-simplify-wrapper
description
Run Claude's built-in /simplify skill on BASE_SHA..HEAD, validate checks, and commit.

Simplify Loop

Input: a git base SHA/ref to simplify against (for example: <sha> or HEAD~1).

Preconditions

  • Confirm you are in the intended repo: git rev-parse --show-toplevel
  • Ensure you have a base commit SHA (prefer the commit from before the change set).
  • Start from a clean working tree (required):
    • git status --porcelain should be empty.
  • Ensure git can create commits (stop if missing):
    • If commits fail due to missing identity, configure user.name and user.email.
  • Only claude CLI is required (no codex dependency).

Scope / intent

  • This is a simplification pass, not a general code review.
  • Invokes Claude's built-in /simplify skill which runs three parallel agents internally:
    • Code reuse (find and eliminate duplication)
    • Code quality (simplify convoluted logic)
    • Code efficiency (remove unnecessary work)
  • Changes are validated (build/lint/test) and committed automatically.

Architecture

Two-phase per iteration:

  1. Simplify subprocess — Invokes claude with the /simplify prompt. The built-in skill handles its own three parallel agents and applies fixes directly to the working tree.
  2. Validate+commit subprocess — A second claude subprocess that runs the repo's standard build/lint/test commands, fixes only breakages introduced by the simplify phase, stages and commits all changes, and emits LOOP_STATUS: {...} so the wrapper can decide whether to continue.

The loop stops when:

  • The simplify phase produces no working-tree changes (nothing to simplify)
  • The validate phase fails to make checks green
  • Max iterations reached

Expected runtime

Typically runs 5–20 minutes per iteration. Allow at least 30 minutes for a single iteration.

Do not interrupt/restart the subagent if it looks stuck. The loop script owns stuck/timeout handling and will exit on its own when it completes or when --timeout is reached.

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

Run

bash
resolve_skill_dir() {
  local name="$1"
  local repo_root=""
  repo_root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"

  local candidates=(
    "$repo_root/.agents/skills/$name"
    "$repo_root/.claude/skills/$name"
    "$HOME/.agents/skills/$name"
    "$HOME/.codex/skills/$name"
    "$HOME/.claude/skills/$name"
  )

  for d in "${candidates[@]}"; do
    if [[ -d "$d" ]]; then
      echo "$d"
      return 0
    fi
  done

  echo "Error: skill '$name' not found in repo-scoped or user-scoped skill dirs." >&2
  return 1
}

SIMPLIFY_SKILL_DIR="$(resolve_skill_dir claude-simplify-wrapper)"
python3 "$SIMPLIFY_SKILL_DIR/scripts/run_simplify_loop.py" <base-sha>

Options:

  • --max-iterations N (default: 1)
  • --model <model> (default: claude-sonnet-4-6)
  • --effort <effort> (default: high)
  • --progress-log <path> and --heartbeat-seconds N
  • --artifacts-dir <path> (optional; stores subprocess outputs)
  • --timeout N (per-subprocess timeout in seconds; default: 3600)
  • --review-only (run simplify phase only; do not validate or commit)
  • --scope <pathspec> (repeatable; restricts git diff to those paths)

Claude automation knobs (env vars; defaults shown):

  • PROMPT_TEMPLATES_CLAUDE_OUTPUT_FORMAT=stream-json (text|json|stream-json)
  • PROMPT_TEMPLATES_CLAUDE_MIN_VERSION=2.1.33 (fail fast if installed Claude Code is older)
  • PROMPT_TEMPLATES_CLAUDE_STREAM_LOG_MAX_BYTES=10485760 (per invocation; set 0 for unlimited)
  • PROMPT_TEMPLATES_CLAUDE_INACTIVITY_TIMEOUT_SECONDS=180 (set 0 to disable)
  • PROMPT_TEMPLATES_CLAUDE_INACTIVITY_MIN_RUNTIME_SECONDS=30
  • PROMPT_TEMPLATES_CLAUDE_PROMPT_BUDGET_BYTES=0 (disabled by default; set >0 to enforce)

Behavior:

  • Each iteration runs in two fresh Claude subprocesses (claude-only, no codex required).
  • Phase 1 invokes the bundled /simplify skill which applies fixes directly.
  • Phase 2 validates changes, fixes any breakages, and commits.
  • Claude subprocesses run in a native PTY (when available) and have an inactivity timeout; on classifiable Claude automation failures the script retries once.
  • The script enforces commit hygiene per iteration: if the validator leaves working-tree changes, it auto-commits them before the next iteration.

Troubleshooting:

  • --progress-log may include full tool outputs (diffs, file contents). Treat it as sensitive; stream-json logs are truncated by default via PROMPT_TEMPLATES_CLAUDE_STREAM_LOG_MAX_BYTES.

© besimple-oss, 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 2 other files (scripts, references) in prompt-templates/skills/claude-simplify-wrapper of besimple-oss/broccoli.

  • SKILL.md
  • references/prompts/simplify-validator-system.md
  • scripts/run_simplify_loop.py

Open the folder on GitHubat commit 6cad3b9

Compare with similar skills

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

Claude Simplify Wrapper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Claude Simplify Wrapper this skillbesimple-oss/broccoli286—~1.1kAutomated safety check: PassMIT
Commit Context Lookuprohitg00/agentmemory29k—~522Automated safety check: PassApache-2.0
Review Triage Phaseprisma/orm48k—~995Automated safety check: PassApache-2.0
Build Px4 macOSPX4/PX4-Autopilot13k—~1.1kAutomated safety check: PassBSD-3-Clause
Leon Coding Agentleon-ai/leon18k—~1.1kAutomated safety check: PassMIT
WorktreeAgentsMesh/AgentsMesh2.4k—~553Automated safety check: NotesCustom licence

Similar skills

  • Commit Context Lookup

    rohitg00/agentmemory

    Traces a file, function or line back to the agent session behind its current commit, using git blame and a memory lookup, and reports only what the records show.

    29k GitHub stars~522 tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Official

    Runs the triage step of the review-framework loop: reads fetched PR review state, builds `review-actions.json`, validates it and renders `review-actions.md`.

    48k GitHub stars~995 tokensUpdated today
    DevelopmentAuto-check passed
  • Build Px4 macOS

    PX4/PX4-Autopilot

    Build PX4 board firmware on macOS in the px4-dev Docker container, including git worktrees, and stage commit-labeled artifacts without flashing hardware.

    13k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Leon Coding Agent

    leon-ai/leon

    Has Leon's agent investigate, change and verify code in a repository with its file, search and shell tools, staying inside the scope the owner authorized.

    18k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Worktree

    AgentsMesh/AgentsMesh

    Creates or reuses an isolated AgentsMesh Git worktree from a verified base branch, preserves existing changes, and optionally starts the worktree-scoped development environment.

    2.4k GitHub stars~553 tokensUpdated 15 days ago
    DevelopmentAuto-check: notes
  • Git Worktree Isolation

    jnMetaCode/superpowers-zh

    Sets up an isolated workspace before feature work or plan execution, preferring native worktree tools and falling back to git worktree, with instructions in Chinese.

    8.3k GitHub starsUsed in 1 repo~982 tokens
    DevelopmentAuto-check passed

More from besimple-oss/broccoli

All 10 skills in this repo
  • Broccoli Oss GCP Deploy

    besimple-oss/broccoli

    Deploy this repository to a new Google Cloud project using the repo's existing Cloud Run, Cloud Run Jobs, Cloud SQL, Secret Manager, and Artifact Registry scripts.

    286 GitHub stars~4.1k tokensUpdated 5 mo ago
    Auto-check passed
  • Plan Critique Loop

    besimple-oss/broccoli

    Critique and revise an existing plan doc up to 3 iterations, using accept/reject triage and stopping early when no important feedback remains.

    286 GitHub stars~1.4k tokensUpdated 5 mo ago
    Auto-check passed
  • Plan Sketch

    besimple-oss/broccoli

    Do bounded research (official docs first) and produce a high-level implementation sketch in sketch/<generated-name.md.

    286 GitHub stars~1.4k tokensUpdated 5 mo ago
    Auto-check passed
  • Plan Write

    besimple-oss/broccoli

    Write a detailed, self-contained implementation plan to a new Markdown file under plan/.

    286 GitHub stars~721 tokensUpdated 5 mo ago
    Auto-check passed
  • Code Review Loop

    besimple-oss/broccoli

    Iterative review+fix loop for BASESHA..HEAD: generate findings, apply accepted fixes, run checks, commit, and re-review up to 3 iterations or until clean.

    286 GitHub stars~1.6k tokensUpdated 5 mo ago
    Auto-check passed
  • Dedup

    besimple-oss/broccoli

    Dedupe-only pass for BASESHA..HEAD: remove duplicate code introduced by the diff or reuse existing shared utils; applies changes + commits.

    286 GitHub stars~1.5k tokensUpdated 5 mo ago
    Auto-check passed

Works with

Questions about Claude Simplify Wrapper

What does Claude Simplify Wrapper do?

Run Claude's built-in /simplify skill on BASESHA..HEAD, validate checks, and commit. Claude Simplify Wrapper is an agent skill from besimple-oss/broccoli.HEAD, validate checks, and commit.

When should I use Claude Simplify Wrapper?

Claude Simplify Wrapper fits situations like: development work in your project.

How do I install Claude Simplify Wrapper in Claude Code?

Run `npx skills add besimple-oss/broccoli --skill claude-simplify-wrapper -a claude-code`. Or copy the skill folder (prompt-templates/skills/claude-simplify-wrapper in besimple-oss/broccoli) into .claude/skills/claude-simplify-wrapper in your project. Claude Code loads it when a task matches its description.

How do I install Claude Simplify Wrapper in Codex?

Run `npx skills add besimple-oss/broccoli --skill claude-simplify-wrapper -a codex`. Or copy the skill folder (prompt-templates/skills/claude-simplify-wrapper in besimple-oss/broccoli) into .agents/skills/claude-simplify-wrapper in your project. Codex loads it when a task matches its description.

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

What does Claude Simplify Wrapper need to run?

Going by SKILL.md and its folder, Claude Simplify Wrapper needs Python for the scripts in its folder and the command-line tools its instructions call (git and python3). Our summary lists: Python 3.

Does Claude Simplify Wrapper 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 Claude Simplify Wrapper 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Claude Simplify Wrapper use?

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

About 1.1k tokens (SKILL.md is roughly 4.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 377 tokens, read only when the agent opens those files.

What are the alternatives to Claude Simplify Wrapper?

Skills that share tags, products or a category with Claude Simplify Wrapper: Commit Context Lookup (rohitg00/agentmemory, 29k stars), Review Triage Phase (prisma/orm, 48k stars), Build Px4 macOS (PX4/PX4-Autopilot, 13k stars) and Leon Coding Agent (leon-ai/leon, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Claude Simplify Wrapper?

besimple-oss (a GitHub organization) maintains it in besimple-oss/broccoli, which has 286 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on April 26, 2026.

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