Agent skill

Skill Evolution

by coco-research in coco-research/coco

A skill your agent uses when running, reviewing or changing coco's self-evolution cycle: the 30-day loop that observes how skills are actually used, proposes evidence-backed edits to them as one…

Custom licenceAuto-check passedDevelopment

Install Skill Evolution

skills CLI
$ npx skills add coco-research/coco --skill skill-evolution -a claude-code

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

GitHub CLI
$ gh skill install coco-research/coco skill-evolution --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/coco-research/coco.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skill-evolution .claude/skills/skill-evolution && 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
skill-evolution
GitHub stars
473
Token cost
~1.2k tokens
SKILL.md length
636 words
Files
8 (incl. scripts, references)
Skills in repo
60
Repo updated
First seen
Licence
Custom licence

At a glance

A skill your agent uses when running, reviewing or changing coco's self-evolution cycle: the 30-day loop that observes how skills are actually used, proposes evidence-backed edits to them as one…

  • Changing cocos self-evolution cycle: the 30-day loop that observes how skills are actually used
  • SKILL.md covers The one rule, What a cycle does, What the guard refuses and Exit codes, plus 4 more sections
  • Runs Python scripts from its folder; calls python3 and bash
  • Proposes evidence-backed edits to them as one branch and one pull request

What it does

Skill Evolution is an agent skill from coco-research/coco. Use when running, reviewing or changing coco's self-evolution cycle: the 30-day loop that observes how skills are actually used, proposes evidence-backed edits to them as one branch and one pull request, and lands nothing without the owner's merge. Also use when asked why a skill changed, what the loop would propose next, or how to reject a proposal so it is not raised again.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts and reference files (for example `references/lanes.json`, `references/proposal-schema.json` and `references/signal-sources.md`).

It sits in Development, covering Pull requests. The repository describes itself as: CoCo Super Intelligence is the orchestration layer that turns Claude Code, Cursor, or Codex into an engineering department: a routed advisory board, 226 skills, 386 commands…

When your agent uses it

  • Changing cocos self-evolution cycle: the 30-day loop that observes how skills are actually used
  • Proposes evidence-backed edits to them as one branch and one pull request
  • Lands nothing without the owners merge
  • Asked why a skill changed

Example prompts

  • “/skill-evolution”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 6036e9c. 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 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • bash

    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

Skill Evolution loads about 1.2k tokens when it runs, and up to ~3.9k if it reads all its reference files. Until then it costs about 99 tokens; SKILL.md has 636 words of instructions outside code blocks.

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

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

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

“A cycle that improves this repository's own skills from observed use, and proposes every change for a human to merge. It never writes to main and never merges.”

— opening of SKILL.md by coco-research, Custom licence
name
skill-evolution
domain
meta

Read the full SKILL.md on GitHub

Files

SKILL.md and 7 other files (scripts, references) in skills/skill-evolution of coco-research/coco.

  • SKILL.md
  • references/lanes.json
  • references/proposal-schema.json
  • references/signal-sources.md
  • scripts/fixtures/ledger/chain.jsonl
  • scripts/fixtures/ledger/malformed.jsonl
  • scripts/ledger.py
  • state/README.md

Open the folder on GitHubat commit 6036e9c

Compare with similar skills

Skill Evolution 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 Evolution compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Evolution this skillcoco-research/coco473—~1.2kAutomated safety check: PassCustom licence
Deskcomm Contribuirmelgarafael/DeskcommCRM4.5k—~3.6kAutomated safety check: NotesMIT
Plan ArbiterBuilderIO/skills4.5k—~1kAutomated safety check: PassMIT
Doesitarm App ReviewThatGuySam/doesitarm3.8k—~826Automated safety check: PassCustom licence
Ecommerce PR Reviewharukiseller-droid/commerce-agent-bench102—~413Automated safety check: PassMIT
Audit FiltersAzure/azure-sdk-tools134—~2.7kAutomated safety check: PassMIT

Similar skills

  • Deskcomm Contribuir

    melgarafael/DeskcommCRM

    Guia de contribuição ao DeskcommCRM para quem vai mexer no código e abrir um pull request, sobretudo de um fork.

    4.5k GitHub stars~3.6k tokensUpdated today
    DevelopmentAuto-check: notes
  • Plan Arbiter

    BuilderIO/skills

    A skill your agent uses when asked to compare, cross-review, merge, judge, choose, or arbitrate competing plans from multiple agents such as Codex and Claude Code; when given two or more proposed…

    4.5k GitHub stars~1k tokensUpdated today
    DevelopmentAuto-check passed
  • Doesitarm App Review

    ThatGuySam/doesitarm

    Review Does It ARM app-listing pull requests and app-request or compatibility-update issues.

    3.8k GitHub stars~826 tokensUpdated today
    DevelopmentAuto-check passed
  • Ecommerce PR Review

    harukiseller-droid/commerce-agent-bench

    Review ecommerce pull requests in a fixed evidence-first order.

    102 GitHub stars~413 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Audit Filters

    Azure/azure-sdk-tools

    Official

    Analyze feedback and memories to suggest filter.yaml additions, then open a PR.

    134 GitHub stars~2.7k tokensUpdated today
    DevelopmentAuto-check passed
  • GitHub Voice

    tobihagemann/turbo

    Shared writing style rules for GitHub-facing output (PR comments, PR descriptions, PR titles, issues, design proposals).

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

More from coco-research/coco

All 60 skills in this repo
  • Coco Ads

    coco-research/coco

    Turn the project you just shipped into a short, polished, shareable launch video (an "ad") using HyperFrames.

    473 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Arch Index

    coco-research/coco

    Build and validate .arch/index.json — a committed map from each architectural component of this repository to the real directories and files that implement it, pinned to a git commit, with every…

    473 GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Coco Diagram

    coco-research/coco

    A skill your agent uses for architecture, current-state, process, data-flow, medallion, or DP diagrams, including redrawing .drawio and Mermaid sources.

    473 GitHub stars~9.2k tokensUpdated today
    Auto-check passed
  • Brain

    coco-research/coco

    A skill your agent uses when the user says brain, project knowledge, what do we know about, open tasks, or recent decisions, or runs /brain or /brain-update.

    473 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • M0

    coco-research/coco

    A skill your agent uses when the user says 'm0', 'm0 status', 'start m0', 'cross-tool memory', 'operational thread', or 'where is my memory stored', or when the M0 daemon or MCP wiring needs…

    473 GitHub stars~755 tokensUpdated today
    Auto-check passed
  • PR To Video

    coco-research/coco

    A skill your agent uses when the user wants a GitHub PR (URL, owner/repoN, or 'this PR') made into a code-change explainer video from its diff and commits: changelog, feature reveal, fix, or refactor.

    473 GitHub stars~7.8k tokensUpdated today
    Auto-check: notes

Questions about Skill Evolution

What does Skill Evolution do?

A skill your agent uses when running, reviewing or changing coco's self-evolution cycle: the 30-day loop that observes how skills are actually used, proposes evidence-backed edits to them as one…. Skill Evolution is an agent skill from coco-research/coco. Use when running, reviewing or changing coco's self-evolution cycle: the 30-day loop that observes how skills are actually used, proposes evidence-backed edits to them as one branch and one pull request, and lands nothing without the owner's merge.

When should I use Skill Evolution?

Skill Evolution fits situations like: changing cocos self-evolution cycle: the 30-day loop that observes how skills are actually used; proposes evidence-backed edits to them as one branch and one pull request; lands nothing without the owners merge; asked why a skill changed.

How do I install Skill Evolution in Claude Code?

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

How do I install Skill Evolution in Codex?

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

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

What does Skill Evolution need to run?

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

Does Skill Evolution 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 Skill Evolution 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 Skill Evolution use?

Skill Evolution 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 Skill Evolution 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. Its references folder adds about 2.6k tokens, read only when the agent opens those files.

What are the alternatives to Skill Evolution?

Skills that share tags, products or a category with Skill Evolution: Deskcomm Contribuir (melgarafael/DeskcommCRM, 4.5k stars), Plan Arbiter (BuilderIO/skills, 4.5k stars), Doesitarm App Review (ThatGuySam/doesitarm, 3.8k stars) and Ecommerce PR Review (harukiseller-droid/commerce-agent-bench, 102 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Evolution?

coco-research (a GitHub user) maintains it in coco-research/coco, which has 473 GitHub stars. The repository holds 60 skills in this directory. The repository was last updated on October 7, 2026.

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