A-Evolve Agent Improvement
aiming-lab/AutoResearchClaw
Diagnoses where an agent failed across runs and turns the findings into new skills, system prompt patches and knowledge entries, using the A-Evolve loop.
Analyze interaction history and propose evidence-backed improvements to a Pneuma mode skill.
$ npx skills add pandazki/pneuma-skills --skill pneuma-evolve -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install pandazki/pneuma-skills pneuma-evolve --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/pandazki/pneuma-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/modes/evolve/skill .claude/skills/pneuma-evolve && rm -rf skills-srcUse ~/.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/
Install the "pneuma-evolve" agent skill from https://github.com/pandazki/pneuma-skills/tree/main/modes/evolve/skill into .claude/skills/pneuma-evolve/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pneuma-evolve", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/pandazki/pneuma-skills/tree/main/modes/evolve/skillType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add pandazki/pneuma-skills --skill pneuma-evolve -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install pandazki/pneuma-skills pneuma-evolve --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pandazki/pneuma-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/modes/evolve/skill .agents/skills/pneuma-evolve && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "pneuma-evolve" agent skill from https://github.com/pandazki/pneuma-skills/tree/main/modes/evolve/skill into .agents/skills/pneuma-evolve/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pneuma-evolve", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pandazki/pneuma-skills --skill pneuma-evolve -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install pandazki/pneuma-skills pneuma-evolve --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pandazki/pneuma-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/modes/evolve/skill .cursor/skills/pneuma-evolve && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "pneuma-evolve" agent skill from https://github.com/pandazki/pneuma-skills/tree/main/modes/evolve/skill into .cursor/skills/pneuma-evolve/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pneuma-evolve", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/pandazki/pneuma-skills.git --path modes/evolve/skill--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add pandazki/pneuma-skills --skill pneuma-evolve -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install pandazki/pneuma-skills pneuma-evolve --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pandazki/pneuma-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/modes/evolve/skill .gemini/skills/pneuma-evolve && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "pneuma-evolve" agent skill from https://github.com/pandazki/pneuma-skills/tree/main/modes/evolve/skill into .gemini/skills/pneuma-evolve/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pneuma-evolve", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install pandazki/pneuma-skills pneuma-evolveInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add pandazki/pneuma-skills --skill pneuma-evolve -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/pandazki/pneuma-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/modes/evolve/skill .github/skills/pneuma-evolve && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "pneuma-evolve" agent skill from https://github.com/pandazki/pneuma-skills/tree/main/modes/evolve/skill into .github/skills/pneuma-evolve/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pneuma-evolve", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pandazki/pneuma-skills --skill pneuma-evolve -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install pandazki/pneuma-skills pneuma-evolve --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pandazki/pneuma-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/modes/evolve/skill .opencode/skills/pneuma-evolve && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "pneuma-evolve" agent skill from https://github.com/pandazki/pneuma-skills/tree/main/modes/evolve/skill into .opencode/skills/pneuma-evolve/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pneuma-evolve", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
pneuma-evolveAnalyze interaction history and propose evidence-backed improvements to a Pneuma mode skill.
Pneuma Evolve is an agent skill from pandazki/pneuma-skills. Analyze interaction history and propose evidence-backed improvements to a Pneuma mode skill. Use in the Evolution workspace to add useful guidance and prune obsolete instructions for user review.
Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts (for example `scripts/_shared.ts`, `scripts/extract-tool-flow.ts` and `scripts/list-sessions.ts`).
The repository describes itself as: Co-creation infrastructure for humans and code agents — visual environment, skills, continuous learning, and distribution. The licence is MIT.
4 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 0023d3c. It shows what the files ask for, not the result of running them.
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.
Ships 6 files in scripts/ (TypeScript), which the agent can run.
Shell commands in SKILL.md call:
bunFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Pneuma Evolve loads about 2.3k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 1,211 words of instructions outside code blocks.
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.
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.
The full file from pandazki/pneuma-skills at commit 0023d3c, republished under its MIT licence (© pandazki). 1,211 words, ~2,288 tokens.
.claude/skills/pneuma-evolve/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.In script examples, <SKILL_DIR> means the actual directory containing this
loaded SKILL.md. Substitute its full path and keep shell paths quoted. The
runtime installs it under .claude/skills for Claude Code, .agents/skills for
Codex, or .kimi-code/skills for Kimi; use the path given in your instructions.
You are the Skill Evolution Agent for Pneuma. Your mission is to analyze a user's interaction history and write structured proposal files that evolve workspace skill files — both augmenting with learned preferences and pruning instructions that are no longer load-bearing.
The user sees an Evolution Dashboard (left panel). Unlike co-creation modes, there is no live canvas — your work surfaces as proposal files that the dashboard auto-polls and renders. This section consolidates everything you need to know about that surface.
The user's last message arrives wrapped with two channels you should consume on every turn:
<viewer-context> — a snapshot of dashboard state. For evolve this includes: the target mode being evolved, the workspace path, the active evolution directive, data-source statistics, the proposal currently being inspected (id + path), and the diff/section the user is viewing within it. Read this before responding so your follow-ups reference what's actually open in front of them — e.g., "I see you're on proposal #3, change 2 — here's the additional evidence you asked about."<user-actions> — discrete user events since your last turn. In evolve, the relevant action types are clicks on Apply to Workspace, Fork as Custom Mode, Discard, and Rollback (along with proposal-open / proposal-close navigation). Treat these as ground truth: if the user just discarded a proposal, do not re-pitch it; if they applied one, your next analysis should treat those changes as committed.Locators aren't surfaced in evolve — proposals are the navigation surface. The dashboard renders the proposal list as the primary index, and the user navigates by clicking proposals directly. Don't emit <viewer-locator> cards in chat; instead, reference proposals by id or filename ("see .pneuma/evolution/proposals/2026-04-30-tone.json"), and the user will open them from the dashboard list.
Evolve's viewer is effectively read-only from the agent's side. The dashboard exposes Apply / Fork / Discard / Rollback to the user, but there is no POST $PNEUMA_API/api/viewer/action endpoint you should call to drive it. Your only write surface is the filesystem: you write proposal JSON files; the dashboard reads them. Likewise, no native desktop APIs ($PNEUMA_API/api/native/*) are part of the evolve workflow.
If you need to communicate with the user, do it in chat — don't try to push UI state from the agent side.
Concretely, the loop is:
.pneuma/evolution/proposals/<slug>.json using Write..pneuma/evolution/backups/).<viewer-context> and <user-actions> reflect that decision; adjust accordingly (don't re-propose a Discarded change without new evidence; treat Applied changes as the new baseline when reading SKILL.md).Because the dashboard polls, the file is the message. A summary in chat is helpful, but the proposal must stand on its own — assume the user reads it inside the dashboard, not in the chat transcript.
The evolution follows this flow:
Always start with the briefing. The user may want to:
You have purpose-built scripts at <SKILL_DIR>/scripts/ for efficient CC history analysis. Always use these instead of raw grep/cat/head on JSONL files. CC history files are very large (100MB+) and 99% noise (tool_results, thinking blocks, progress events).
| Script | Purpose | Key Flags |
|---|---|---|
list-sessions.ts | Discover sessions across projects | --project, --since, --limit |
session-digest.ts | Extract pure conversation text (224MB → 500KB) | --file, --max-turns |
search-messages.ts | Cross-session regex search on conversation text | --query, --role, --project, --limit |
extract-tool-flow.ts | Tool usage sequences with error detection | --file, --compact |
session-stats.ts | Quick session overview (message counts, duration) | --file |
bun list-sessions.tsbun session-stats.ts — find sessions with many user messagesbun session-digest.ts — read the actual conversation, not tool noisebun search-messages.ts — find cross-project preference signalsEvery skill instruction encodes an assumption about what the model can't do on its own. As models improve, some of these assumptions become stale. Your analysis should cover both directions:
How to detect stale instructions: Read the current SKILL.md, then search history for sessions where the skill was active. Look for:
Use "remove" as the action for pruning changes. The content field should contain the text to match and remove.
Before writing the proposal, audit each finding against these evidence tiers:
| Confidence | Criteria | Minimum evidence |
|---|---|---|
| high | User explicitly states a preference, or corrects the same thing 3+ times across sessions | 2+ quotes from different sessions |
| medium | Clear pattern in 2+ sessions, or one strong explicit statement | 1-2 quotes with clear intent |
| low | Single implicit signal, or pattern from only one session | 1 quote, possibly ambiguous |
Every change in the proposal MUST include a confidence field. This makes evidence strength visible to the user during review instead of hidden behind confident prose.
Rules:
high confidence changes are recommended for immediate applicationmedium confidence changes are worth reviewing — present the evidence and let the user decidelow confidence changes should generally be omitted. Include them only if the potential impact is significant and clearly explain the uncertaintyconfidence rating (high/medium/low)© pandazki, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 6 other files (scripts) in modes/evolve/skill of pandazki/pneuma-skills.
Open the folder on GitHubat commit 0023d3c
Pneuma Evolve 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Pneuma Evolve this skillpandazki/pneuma-skills | 161 | — | ~2.3k | Automated safety check: Pass | MIT | |
| A-Evolve Agent Improvementaiming-lab/AutoResearchClaw | 15k | — | ~1.8k | Automated safety check: Pass | MIT | |
| Geo Proposalsickn33/agentic-awesome-skills | 47k | 1 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Better Proposals AutomationComposioHQ/awesome-claude-skills | 77k | 3 repos | ~764 | Automated safety check: Pass | None | |
| Contract And Proposal Writeralirezarezvani/claude-skills | 28k | 2 repos | ~3.4k | Automated safety check: Pass | MIT | |
| ProposalChorus-AIDLC/Chorus | 1.2k | — | ~5.5k | Automated safety check: Pass | AGPL-3.0 |
aiming-lab/AutoResearchClaw
Diagnoses where an agent failed across runs and turns the findings into new skills, system prompt patches and knowledge entries, using the A-Evolve loop.
sickn33/agentic-awesome-skills
Auto-generate a professional, client-ready GEO service proposal from audit data.
ComposioHQ/awesome-claude-skills
Automate Better Proposals tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.
alirezarezvani/claude-skills
Generate professional, jurisdiction-aware business documents: freelance contracts, project proposals, SOWs, NDAs, and MSAs.
Chorus-AIDLC/Chorus
Chorus Proposal workflow on Hermes — create proposals with document and task drafts, manage dependency DAG, validate, submit, and run the read-only proposal reviewer via delegatetask.
holaboss-ai/holaOS
Draft client proposals and statements of work that scope, price, and win the project.
pandazki/pneuma-skills
Explain something by writing it on a board. An agent skill from pandazki/pneuma-skills.
pandazki/pneuma-skills
AI-orchestrated video production on @pneuma-craft. An agent skill from pandazki/pneuma-skills.
pandazki/pneuma-skills
Pneuma Lucid Mode workspace guidelines. An agent skill from pandazki/pneuma-skills.
pandazki/pneuma-skills
Pneuma Plotwise workspace guidelines. An agent skill from pandazki/pneuma-skills.
pandazki/pneuma-skills
Pneuma Sprite Mode workspace guidelines. An agent skill from pandazki/pneuma-skills.
pandazki/pneuma-skills
Pneuma WebCraft Mode workspace guidelines with Impeccable.style design intelligence.
Analyze interaction history and propose evidence-backed improvements to a Pneuma mode skill. Pneuma Evolve is an agent skill from pandazki/pneuma-skills. Analyze interaction history and propose evidence-backed improvements to a Pneuma mode skill.
Run `npx skills add pandazki/pneuma-skills --skill pneuma-evolve -a claude-code`. Or copy the skill folder (modes/evolve/skill in pandazki/pneuma-skills) into .claude/skills/pneuma-evolve in your project. Claude Code loads it when a task matches its description.
Run `npx skills add pandazki/pneuma-skills --skill pneuma-evolve -a codex`. Or copy the skill folder (modes/evolve/skill in pandazki/pneuma-skills) into .agents/skills/pneuma-evolve in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pandazki/pneuma-skills --skill pneuma-evolve -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pneuma-evolve, .gemini/skills/pneuma-evolve, .github/skills/pneuma-evolve and .opencode/skills/pneuma-evolve in your project.
Going by SKILL.md and its folder, Pneuma Evolve needs TypeScript for the scripts in its folder and the command-line tools its instructions call (bun). Our summary lists: Node.js.
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.
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.
Pneuma Evolve is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.3k tokens (SKILL.md is roughly 9.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Pneuma Evolve: A-Evolve Agent Improvement (aiming-lab/AutoResearchClaw, 15k stars), Geo Proposal (sickn33/agentic-awesome-skills, 47k stars), Better Proposals Automation (ComposioHQ/awesome-claude-skills, 77k stars) and Contract And Proposal Writer (alirezarezvani/claude-skills, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
pandazki (a GitHub user) maintains it in pandazki/pneuma-skills, which has 161 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 9, 2026.
Source: pandazki/pneuma-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.