Agent skill

Improve System

by real-simple-labs in real-simple-labs/parker-brain

Apply the self-improvement system on demand. An agent skill from real-simple-labs/parker-brain.

Custom licenceAuto-check passed

Install Improve System

skills CLI
$ npx skills add real-simple-labs/parker-brain --skill improve-system -a claude-code

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

GitHub CLI
$ gh skill install real-simple-labs/parker-brain improve-system --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/real-simple-labs/parker-brain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/improve-system .claude/skills/improve-system && 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
improve-system
GitHub stars
100
Token cost
~2.4k tokens
SKILL.md length
1,376 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
Custom licence

At a glance

Apply the self-improvement system on demand. An agent skill from real-simple-labs/parker-brain.

  • Works in 9 steps: Load the method. Read… → Set the scope. Identify the brand and… → Gather the traces. Read across… → …
  • Jimmy runs /improve-system
  • SKILL.md covers Goal, Where this skill sits, What this skill updates and How this skill runs, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Improve System is an agent skill from real-simple-labs/parker-brain. Apply the self-improvement system on demand. Read the accumulated reasoning traces and update this brand's and this user's living context to reflect what Parker has learned. Use when Jimmy runs /improve-system or asks Parker to apply what it has learned, fold the traces in, or get this brand's context up to date with recent feedback.

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

When your agent uses it

  • Jimmy runs /improve-system
  • Asks Parker to apply what it has learned
  • Fold the traces in
  • Get this brands context up to date with recent feedback

Example prompts

  • “s and this user”
  • “/improve-system”

Workflow steps

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

  1. Load the method. Read parker-system/self-improvement/self-improvement-system.md (at the root in the factory). It governs scope…
  2. Set the scope. Identify the brand and the user this pass is for. Default to the current brand in context and the current user. If either…
  3. Gather the traces. Read across self-improvement/reasoning-traces/[YYYY-MM]/, the repeated themes in patterns/INDEX.md, and anything parked…
  4. Cluster and dedupe. Group traces that teach the same lesson. A lesson repeated across three traces is stronger evidence than one; note the…
  5. Decide what is promotable. For each cluster, check the promotion condition from the method: explicit user approval, repeated traces…
  6. Fold each promotable lesson into its narrowest correct surface. Use the brand and user targets above. Update the living surface; do not…
  7. Mark state honestly. Where a trace cleanly meets its promotion condition and the user has invoked this pass to apply it, write the update…
  8. Keep the human in the loop. Parker can fold in what is clearly decided, but it does not silently promote an inferred why or stretch a…
  9. Report back. Tell the user what landed where: what was applied to the brand, what was applied to the user, what is [~] pending review…

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Improve System loads about 2.4k tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 1,376 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,376 words (~2,447 tokens).

“Turn the reasoning traces Parker has been capturing into actual updates to the two surfaces the user named when they ran this: this brand's context and this person's context. Capture already happened — self-improvement-intake wrote the traces during conversation. This…”

— opening of SKILL.md by real-simple-labs, Custom licence
name
improve-system
triggers
/improve-system, improve system, improve the system, apply the reasoning traces, apply what you've learned, fold in the traces, update this brand's context…

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/improve-system of real-simple-labs/parker-brain.

Open the folder on GitHubat commit 62c4f72

Compare with similar skills

Improve System 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.

Improve System compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Improve System this skillreal-simple-labs/parker-brain100—~2.4kAutomated safety check: PassCustom licence
Deepseek Reasonruvnet/ruflo74k—~626Automated safety check: NotesMIT
Skill Improversickn33/agentic-awesome-skills47k2 repos~1.5kAutomated safety check: PassMIT
Improve Oaselastic/kibana21k—~4.8kAutomated safety check: PassCustom licence
Demand Receivedanthropics/claude-for-legal9.6k2 repos~3.4kAutomated safety check: PassApache-2.0
Demand Intakeanthropics/claude-for-legal9.6k2 repos~3.2kAutomated safety check: PassApache-2.0

Similar skills

  • Deepseek Reason

    ruvnet/ruflo

    Reasoning-mode completion against DeepSeek's deepseek-reasoner model (R1) via /v1/chat/completions.

    74k GitHub stars~626 tokensUpdated today
    AI & LLM EngineeringAuto-check: notes
  • Skill Improver

    sickn33/agentic-awesome-skills

    Iteratively improve a Claude Code skill using the skill-reviewer agent until it meets quality standards.

    47k GitHub starsUsed in 2 repos~1.5k tokens
    Agent WorkflowsAuto-check passed
  • Improve Oas

    elastic/kibana

    Official

    Add or improve OpenAPI descriptions, examples, and code samples for a Kibana API area.

    21k GitHub stars~4.8k tokensUpdated today
    Backend & APIsAuto-check passed
  • Demand Received

    anthropics/claude-for-legal

    Official

    Triage an inbound demand letter — extract fields, cross-check the portfolio, assess merit, present response options with a recommendation, and hand off to matter-intake or demand-intake if…

    9.6k GitHub starsUsed in 2 repos~3.4k tokens
    Legal & ComplianceAuto-check passed
  • Demand Intake

    anthropics/claude-for-legal

    Official

    Pre-drafting context gathering for a demand letter — parties, facts, basis, leverage, BATNA, and privilege filters — written to a structured intake.md the demand-draft skill reads.

    9.6k GitHub starsUsed in 2 repos~3.2k tokens
    Legal & ComplianceAuto-check passed
  • Ejentum Reasoning Harness

    sickn33/agentic-awesome-skills

    MCP server exposing four cognitive harness modes (reasoning, code, anti-deception, memory).

    47k GitHub starsUsed in 1 repo~1.9k tokens
    DevelopmentAuto-check passed

More from real-simple-labs/parker-brain

All 20 skills in this repo
  • Open Loops Advance

    real-simple-labs/parker-brain

    Turn a promoted open loop into a hypothesis — a falsifiable prediction plus the few complementary pulls that together settle it, triangulated across the ad account, reviews, and competitors as the…

    100 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Open Loops Validate

    real-simple-labs/parker-brain

    Run a hypothesis's test plan, gather the evidence, and honestly resolve the loop into one of the four validation states — validated, invalidated, inconclusive, or insufficient evidence.

    100 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Propagate Craft

    real-simple-labs/parker-brain

    Push-based re-ship of the factory methodology bundle into brand brains that carry the method as copied files — the legacy vendored-parker-system layout and decoupled brains that asked for a refresh.

    100 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Update Parker Skill

    real-simple-labs/parker-brain

    Make a correct update to Parker's prompts, system docs, rubrics, knowledge docs, training corpus, or brand outputs — and propagate the change everywhere it needs to land.

    100 GitHub stars~4.6k tokensUpdated today
    Auto-check passed
  • Ad Account Analysis

    real-simple-labs/parker-brain

    Analyze Meta ad account data — read what's spending, what's converting, what's fatiguing, and where the audience is being reached.

    100 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Dream

    real-simple-labs/parker-brain

    Run the dreaming system on demand for a brand and the person using it.

    100 GitHub stars~3k tokensUpdated today
    Auto-check passed

Questions about Improve System

What does Improve System do?

Apply the self-improvement system on demand. An agent skill from real-simple-labs/parker-brain. Improve System is an agent skill from real-simple-labs/parker-brain. Apply the self-improvement system on demand.

When should I use Improve System?

Improve System fits situations like: jimmy runs /improve-system; asks Parker to apply what it has learned; fold the traces in; get this brands context up to date with recent feedback.

How do I install Improve System in Claude Code?

Run `npx skills add real-simple-labs/parker-brain --skill improve-system -a claude-code`. Or copy the skill folder (.claude/skills/improve-system in real-simple-labs/parker-brain) into .claude/skills/improve-system in your project. Claude Code loads it when a task matches its description.

How do I install Improve System in Codex?

Run `npx skills add real-simple-labs/parker-brain --skill improve-system -a codex`. Or copy the skill folder (.claude/skills/improve-system in real-simple-labs/parker-brain) into .agents/skills/improve-system in your project. Codex loads it when a task matches its description.

Can I use Improve System 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 real-simple-labs/parker-brain --skill improve-system -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/improve-system, .gemini/skills/improve-system, .github/skills/improve-system and .opencode/skills/improve-system in your project.

What does Improve System need to run?

SKILL.md names no scripts, command-line tools or credentials: Improve System is instructions for the agent only.

Does Improve System access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Improve System 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 Improve System use?

Improve System has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Improve System use?

About 2.4k tokens (SKILL.md is roughly 9.8k 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 Improve System?

Skills that share tags, products or a category with Improve System: Deepseek Reason (ruvnet/ruflo, 74k stars), Skill Improver (sickn33/agentic-awesome-skills, 47k stars), Improve Oas (elastic/kibana, 21k stars) and Demand Received (anthropics/claude-for-legal, 9.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Improve System?

real-simple-labs (a GitHub organization) maintains it in real-simple-labs/parker-brain, which has 100 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 9, 2026.

Source: real-simple-labs/parker-brain on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.