Agent skill

Skill Evolve

by UniClipboard in UniClipboard/UniClipboard

Meta-skill for evolving other skills. An agent skill from UniClipboard/UniClipboard.

AGPL-3.0Auto-check passed

Install Skill Evolve

skills CLI
$ npx skills add UniClipboard/UniClipboard --skill skill-evolve -a claude-code

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

GitHub CLI
$ gh skill install UniClipboard/UniClipboard skill-evolve --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/UniClipboard/UniClipboard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/skill-evolve .claude/skills/skill-evolve && 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-evolve
GitHub stars
1.9k
Token cost
~957 tokens
SKILL.md length
397 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Meta-skill for evolving other skills. An agent skill from UniClipboard/UniClipboard.

  • Works in 4 steps: Gather Context → Classify the Learning → Draft the Update → …
  • SKILL.md covers When to Use, Procedure, Quality Gates and Anti-Patterns for This Skill
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Skill Evolve is an agent skill from UniClipboard/UniClipboard. Meta-skill for evolving other skills. Invoke after resolving a real-world issue to extract lessons and merge them into the referenced SKILL.md. Usage - $skill-evolve @path/to/SKILL.md

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

The repository describes itself as: Real-time clipboard sync across all your devices — local-first, peer-to-peer, and end-to-end encrypted. No account. No cloud dependency. No central server. The licence is AGPL-3.0.

Example prompts

  • “/skill-evolve”

Workflow steps

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

  1. Gather Context
  2. Classify the Learning
  3. Draft the Update
  4. Apply and Summarize

What it can do on your machine

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

Skill Evolve loads about 957 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 397 words of instructions outside code blocks.

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

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 UniClipboard/UniClipboard at commit 101ffb3, republished under its AGPL-3.0 licence (© UniClipboard). 397 words, ~957 tokens.

Download SKILL.mdSave it as .claude/skills/skill-evolve/SKILL.md (or your agent's skills folder).
name
skill-evolve
description
Meta-skill for evolving other skills. Invoke after resolving a real-world issue to extract lessons and merge them into the referenced SKILL.md. Usage - $skill-evolve @path/to/SKILL.md

Skill Evolve

Turn real-world experience into durable skill knowledge.

When to Use

User invokes this skill after completing work that revealed a gap, pitfall, or new pattern not yet captured in an existing SKILL.md. Typical trigger: $skill-evolve @path/to/SKILL.md

Procedure

Step 1 — Gather Context
  1. Read the referenced SKILL.md in full.
  2. Review the current conversation to identify:
    • What went wrong or was discovered (the incident/finding)
    • Root cause (why it happened)
    • The fix or pattern (what the correct approach is)
    • Why the existing skill didn't prevent it (the gap)
Step 2 — Classify the Learning

Determine which type of update is needed:

TypeDescriptionExample
New RuleA pattern/anti-pattern not covered at all.entered() in async is forbidden
Rule RefinementExisting rule needs caveats or edge casesskip_all needed when params include trait objects
New ExampleCorrect/incorrect code pattern to illustrate existing ruleasync {}.instrument(span).await for match arms
Checklist AdditionNew review checkpoint".entered() held across .await? FORBIDDEN"
Section ExpansionExisting section needs a new subsectionAdding async lifecycle patterns to spawn section
Step 3 — Draft the Update

Write the proposed additions following these principles:

  • Match the existing style — same heading levels, table formats, code block conventions
  • Place it where it belongs — near related content, not appended randomly at the end
  • Lead with the rule, then the why, then the example
  • Include both CORRECT and FORBIDDEN patterns when adding anti-patterns
  • Keep it concise — skills are reference material, not tutorials
Show full SKILL.md (160 more words)Show less
Step 4 — Apply and Summarize
  1. Edit the SKILL.md with the new content.
  2. Present a summary to the user:
text
## Skill Evolution Summary

**Skill**: <skill name>
**Trigger**: <what happened that revealed the gap>
**Update type**: <New Rule | Rule Refinement | New Example | Checklist Addition | Section Expansion>
**What was added**:
- <bullet summary of each change>
**Section(s) modified**: <list of modified section numbers/names>

Quality Gates

Before applying the update, verify:

  • The new content does NOT duplicate existing rules (check the full SKILL first)
  • The new content is grounded in a real incident from this conversation (not hypothetical)
  • Code examples compile conceptually (correct syntax, realistic types)
  • The learning is generalizable — useful beyond this one specific case
  • If adding a FORBIDDEN pattern, a CORRECT alternative is shown alongside it

Anti-Patterns for This Skill

  • Don't bloat: If the learning is too narrow or one-off, suggest the user add it to memory instead of a skill
  • Don't rewrite: Evolve the skill incrementally. Don't restructure or rewrite existing sections unless they are wrong
  • Don't speculate: Only add patterns that were validated in practice during this conversation
  • Don't duplicate: If the fix was specific to this codebase and not transferable, it belongs in the nearest AGENTS.md, not a skill

© UniClipboard, AGPL-3.0. 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/skill-evolve of UniClipboard/UniClipboard.

Open the folder on GitHubat commit 101ffb3

Compare with similar skills

Skill 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 Evolve compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Evolve this skillUniClipboard/UniClipboard1.9k—~957Automated safety check: PassAGPL-3.0
Harness Evolveruvnet/ruflo74k—~1.6kAutomated safety check: NotesMIT
A-Evolve Agent Improvementaiming-lab/AutoResearchClaw15k—~1.8kAutomated safety check: PassMIT
Threejs World Generationcalesthio/OpenMontage65k—~2kAutomated safety check: PassAGPL-3.0
Resolve Git Conflictspenpot/penpot61k—~772Automated safety check: PassMPL-2.0
A-Evolve Agent EvolutionOrchestra-Research/AI-Research-SKILLs13k1 repos~3.6kAutomated safety check: PassMIT

Similar skills

  • Harness Evolve

    ruvnet/ruflo

    Run @metaharness/darwin evolve <repo to mutate a harness's seven policy surfaces (planner/contextBuilder/reviewer/retryPolicy/toolPolicy/memoryPolicy/scorePolicy), sandbox-score each variant, and…

    74k GitHub stars~1.6k tokensUpdated today
    DevelopmentAuto-check: notes
  • 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.

    15k GitHub stars~1.8k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Threejs World Generation

    calesthio/OpenMontage

    Build deterministic, editable, free-viewpoint Three.js worlds from text or structured briefs.

    65k GitHub stars~2k tokensUpdated 4 days ago
    Game DevelopmentAuto-check passed
  • Conflict resolution flow — understand the local git conflicts, present a resolution plan, and resolve them after the user approves it.

    61k GitHub stars~772 tokensUpdated today
    DevelopmentAuto-check passed
  • A-Evolve Agent Evolution

    Orchestra-Research/AI-Research-SKILLs

    Guidance for using A-Evolve to improve an AI agent automatically, evolving its prompts, skills and memory against a benchmark through solve, observe and evolve cycles.

    13k GitHub starsUsed in 1 repo~3.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Official

    Diagnoses and resolves PostHog ingestion warnings — problems recorded while ingesting events (dropped events, rejected person merges, oversized payloads, invalid data).

    40k GitHub stars~7k tokensUpdated today
    Auto-check passed

More from UniClipboard/UniClipboard

All 24 skills in this repo
  • Beui

    UniClipboard/UniClipboard

    Pick and install beUI (@beui) animated React components from the shadcn registry.

    1.9k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Create PR

    UniClipboard/UniClipboard

    Push the current branch and open a GitHub pull request against main.

    1.9k GitHub stars~4.6k tokensUpdated today
    Auto-check passed
  • Design Audit

    UniClipboard/UniClipboard

    定期审计代码库的工程设计问题(高心智复杂度、单一真相源被破坏、catch-all 胖接口、死代码、散落魔法字面量、泄漏抽象、资源生命周期靠环形缓冲)与可优化点,范围限定为自上次审计以来的 git churn,每条发现都落到 file:line 并对照本项目自己的 VISION.md / 各级 AGENTS.md / memory…

    1.9k GitHub stars~554 tokensUpdated today
    Auto-check passed
  • Dual Side Debug

    UniClipboard/UniClipboard

    Inspect uniclipboard logs from BOTH the macOS host and the mounted Windows peer when debugging cross-platform sync, pairing, transfer, or daemon issues.

    1.9k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • E2E Test Thinker

    UniClipboard/UniClipboard

    Analyze the current branch's diff against main and determine which changes are testable via CLI-based end-to-end tests.

    1.9k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • iOS Log Diagnose

    UniClipboard/UniClipboard

    Drive the UniClipboard iOS app in a simulator and read its OSLog yourself to diagnose a mobile-sync bug, instead of asking the user to paste logs.

    1.9k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Questions about Skill Evolve

What does Skill Evolve do?

Meta-skill for evolving other skills. An agent skill from UniClipboard/UniClipboard. Skill Evolve is an agent skill from UniClipboard/UniClipboard. Meta-skill for evolving other skills.

How do I install Skill Evolve in Claude Code?

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

How do I install Skill Evolve in Codex?

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

Can I use Skill Evolve 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 UniClipboard/UniClipboard --skill skill-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/skill-evolve, .gemini/skills/skill-evolve, .github/skills/skill-evolve and .opencode/skills/skill-evolve in your project.

What does Skill Evolve need to run?

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

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

Skill Evolve is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Evolve use?

About 957 tokens (SKILL.md is roughly 3.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 Skill Evolve?

Skills that share tags, products or a category with Skill Evolve: Harness Evolve (ruvnet/ruflo, 74k stars), A-Evolve Agent Improvement (aiming-lab/AutoResearchClaw, 15k stars), Threejs World Generation (calesthio/OpenMontage, 65k stars) and Resolve Git Conflicts (penpot/penpot, 61k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Evolve?

UniClipboard (a GitHub organization) maintains it in UniClipboard/UniClipboard, which has 1,856 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 8, 2026.

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