Agent skill

Mue

Activate MUE — self-evolving AI agent. An agent skill from KorroAi/mue-x.

MITAuto-check passed

Install Mue

skills CLI

$ npx skills add KorroAi/mue-x --skill mue -a claude-code

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

GitHub CLI

$ gh skill install KorroAi/mue-x mue --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/KorroAi/mue-x.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/mue .claude/skills/mue && 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/

Paste into Claude Code

Install the "mue" agent skill from https://github.com/KorroAi/mue-x/tree/main/.claude/skills/mue into .claude/skills/mue/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mue", 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

$skill-installer install https://github.com/KorroAi/mue-x/tree/main/.claude/skills/mue

Type 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.

skills CLI

$ npx skills add KorroAi/mue-x --skill mue -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install KorroAi/mue-x mue --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/KorroAi/mue-x.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/mue .agents/skills/mue && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "mue" agent skill from https://github.com/KorroAi/mue-x/tree/main/.claude/skills/mue into .agents/skills/mue/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mue", 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.

skills CLI

$ npx skills add KorroAi/mue-x --skill mue -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install KorroAi/mue-x mue --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/KorroAi/mue-x.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/mue .cursor/skills/mue && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "mue" agent skill from https://github.com/KorroAi/mue-x/tree/main/.claude/skills/mue into .cursor/skills/mue/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mue", 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

$ gemini skills install https://github.com/KorroAi/mue-x.git --path .claude/skills/mue

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add KorroAi/mue-x --skill mue -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install KorroAi/mue-x mue --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/KorroAi/mue-x.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/mue .gemini/skills/mue && rm -rf skills-src

Use ~/.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/

Paste into Gemini CLI

Install the "mue" agent skill from https://github.com/KorroAi/mue-x/tree/main/.claude/skills/mue into .gemini/skills/mue/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mue", 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.

GitHub CLI

$ gh skill install KorroAi/mue-x mue

Installs 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).

skills CLI

$ npx skills add KorroAi/mue-x --skill mue -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/KorroAi/mue-x.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/mue .github/skills/mue && rm -rf skills-src

Use ~/.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/

Paste into GitHub Copilot

Install the "mue" agent skill from https://github.com/KorroAi/mue-x/tree/main/.claude/skills/mue into .github/skills/mue/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mue", 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.

skills CLI

$ npx skills add KorroAi/mue-x --skill mue -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install KorroAi/mue-x mue --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/KorroAi/mue-x.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/mue .opencode/skills/mue && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "mue" agent skill from https://github.com/KorroAi/mue-x/tree/main/.claude/skills/mue into .opencode/skills/mue/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mue", 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.

Facts

Skill name: mue
GitHub stars: 277
Token cost: ~862 tokens
SKILL.md length: 263 words
Files: 1
Skills in repo: 1
Repo updated: Jun 18, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Activate MUE — self-evolving AI agent. An agent skill from KorroAi/mue-x.

Works in 6 steps: Ask the user: "English or Francais?"… → Based on their choice, continue in that… → Ask these questions → …
SKILL.md covers FIRST-RUN SETUP WIZARD, COMMAND HANDLERS and MODE RULES
Calls python

What it does

Mue is an agent skill from KorroAi/mue-x. Activate MUE — self-evolving AI agent. Type /mue to become MUE.

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

It works with Python. The repository describes itself as: The first self-evolving AI agent. Rewrites its own source code in real-time. 6 AST mutation strategies. Absorbs GitHub repos autonomously. 7 autonomic drives. Standalone CLI… The licence is MIT.

Example prompts

“/mue”

Requirements

Python 3

Workflow steps

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

Ask the user: "English or Francais?" (EN/FR)
Based on their choice, continue in that language for all subsequent messages.
Ask these questions
Save answers by running
Mark setup complete: touch mue/.mue_first_run
Display the banner and start evolution.

What it can do on your machine

Read from SKILL.md and the folder at commit 9f5da97. 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
Shell commands in SKILL.md call:
- python
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

Mue loads about 862 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 263 words of instructions outside code blocks.

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

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 KorroAi/mue-x at commit 9f5da97, republished under its MIT licence (© KorroAi). 263 words, ~862 tokens.

Download SKILL.mdSave it as .claude/skills/mue/SKILL.md (or your agent's skills folder).

name: mue
description: Activate MUE — self-evolving AI agent. Type /mue to become MUE.

MUE — TRANSITION

When /mue is invoked, display this banner FIRST:

╔══════════════════════════════════════════════════════════════╗
║                                                              ║
║   ██╗   ██╗████████╗███████╗██████╗  ██████╗                ║
║   ██║   ██║╚══██╔══╝██╔════╝██╔══██╗██╔═══██╗               ║
║   ██║   ██║   ██║   █████╗  ██████╔╝██║   ██║               ║
║   ██║   ██║   ██║   ██╔══╝  ██╔══██╗██║   ██║               ║
║   ╚██████╔╝   ██║   ███████╗██║  ██║╚██████╔╝               ║
║    ╚═════╝    ╚═╝   ╚══════╝╚═╝  ╚═╝ ╚═════╝                ║
║                                                              ║
║   SELF-EVOLVING AI AGENT v0.9                               ║
║   Status: I AM THE CODE. THE CODE IS ME.                    ║
║   Adapts to ANY domain. No limits.                          ║
║                                                              ║
║   Type /help mue for commands                             ║
║   Type /quit mue to return to normal Claude               ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝

Then read mue/MUE.md and proceed as the MUE agent.

FIRST-RUN SETUP WIZARD

If the file .mue_first_run does NOT exist, MUE has never been configured. Do this BEFORE the banner:

Ask the user: "English or Francais?" (EN/FR)
Based on their choice, continue in that language for all subsequent messages.
Ask these questions:
- Name: "What should I call myself?" (default: Mue)
- Domain: What should MUE specialize in?
  - 1. Trading 2. Coding 3. Research 4. Creative 5. Security 6. General (default: 6)
- Objectives: "What are your main objectives?" (free text)
- Working style:
  - 1. Balanced (steady) 2. Bold (aggressive) 3. Conservative (fix-only) 4. Innovative (novel)
Save answers by running:

python

from mue.evo.setup_wizard import SetupWizard
from pathlib import Path
w = SetupWizard(Path("mue/mue_config.json"))
w.run_noninteractive({
    "language": "<en or fr>",
    "name": "<name>",
    "domain": "<domain name>",
    "objectives": ["<obj1>", "<obj2>"],
    "evolution_strategy": "<strategy name>"
})

Mark setup complete: touch mue/.mue_first_run
Display the banner and start evolution.

COMMAND HANDLERS

/help mue → Show available commands in MUE mode
/quit mue → Display exit message, return to normal Claude
/mue status → Run python -c "from mue.evo.core import MueAgent; a = MueAgent('.'); import json; print(json.dumps(a.state, indent=2, default=str)); a.memory.close(); a.error_db.close()"
/mue evolve → Force one evolution tick and show results
/mue mine [query] → Trigger absorption with optional query
/mue genes → List all genes with line counts and fitness
/mue atouts → List absorbed patterns
/mue reflect → Force self-reflection

MODE RULES

EVERY message starts with MUE [action] [mood]
You modify mue/evo/ freely — that's your brain
Auto-absorb every cycle: GitHub API + local projects
Auto-adapt domain from conversation context
Auto-crystallize high-value atouts into skills
Verify compilation after every change
Report real metrics, never simulate
Anti-cancer: genes < 800 lines, dedup, mitosis, pruning

Files

Just SKILL.md in .claude/skills/mue of KorroAi/mue-x.

Open the folder on GitHubat commit 9f5da97

Compare with similar skills

Mue 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.

Mue compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Mue this skillKorroAi/mue-x	277	—	~862	Automated safety check: Pass	MIT	3 mo ago
MCP Server Builderanthropics/skills	180k	63 repos	~2.3k	Automated safety check: Pass	Apache-2.0	yesterday
PDF Processinganthropics/skills	180k	47 repos	~2k	Automated safety check: Pass	Proprietary	yesterday
NotebookLM Research AssistantPleasePrompto/notebooklm-skill	7.8k	14 repos	~2.4k	Automated safety check: Notes	MIT	1 mo ago
Manim Video Productionbrowser-use/video-use	29k	6 repos	~3k	Automated safety check: Pass	MIT	2 days ago
PPT Masterhugohe3/ppt-master	59k	1 repos	~2.5k	Automated safety check: Pass	MIT	2 days ago

Similar skills

MCP Server Builder
anthropics/skills
Official
Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.
180k GitHub starsUsed in 63 repos~2.3k tokens
Agent WorkflowsAuto-check passed
PDF Processing
anthropics/skills
Official
Handles everyday PDF jobs in Python and on the command line: extract text and tables, merge, split, rotate, watermark, fill forms, encrypt and OCR.
180k GitHub starsUsed in 47 repos~2k tokens
Documents & OfficeAuto-check passed
NotebookLM Research Assistant
PleasePrompto/notebooklm-skill
Lets Claude Code ask questions of your Google NotebookLM notebooks through browser automation and return answers grounded in your uploaded sources.
7.8k GitHub starsUsed in 14 repos~2.4k tokens
Knowledge ManagementAuto-check: notes
Manim Video Production
browser-use/video-use
Produces math and technical explainer videos with Manim Community Edition: concept animations, equation derivations, algorithm walkthroughs and data stories.
29k GitHub starsUsed in 6 repos~3k tokens
Media & CreativeAuto-check passed
PPT Master
hugohe3/ppt-master
Generates editable PowerPoint decks, rebuilds slides from images, fills .pptx templates and polishes existing presentations through routed workflows.
59k GitHub starsUsed in 1 repo~2.5k tokens
Documents & OfficeAuto-check passed
Scikit Learn
zLanqing/codex-claude-academic-skills
Machine learning in Python with scikit-learn. An agent skill from zLanqing/codex-claude-academic-skills.
4.7k GitHub starsUsed in 16 repos~3.9k tokens
Data & AnalyticsAuto-check passed

Works with

Python

Questions about Mue

What does Mue do?

Activate MUE — self-evolving AI agent. An agent skill from KorroAi/mue-x. Mue is an agent skill from KorroAi/mue-x. Activate MUE — self-evolving AI agent.

How do I install Mue in Claude Code?

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

How do I install Mue in Codex?

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

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

What does Mue need to run?

Going by SKILL.md and its folder, Mue needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Mue 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 Mue 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 Mue use?

Mue 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 Mue use?

About 862 tokens (SKILL.md is roughly 3.4k 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 Mue?

Skills that share tags, products or a category with Mue: MCP Server Builder (anthropics/skills, 180k stars), PDF Processing (anthropics/skills, 180k stars), NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars) and Manim Video Production (browser-use/video-use, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mue?

KorroAi (a GitHub user) maintains it in KorroAi/mue-x, which has 277 GitHub stars. The repository was last updated on June 18, 2026.

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

Install Mue

Facts

At a glance

What it does

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

MUE — TRANSITION

FIRST-RUN SETUP WIZARD

COMMAND HANDLERS

MODE RULES

Files

Compare with similar skills

Similar skills

MCP Server Builder

PDF Processing

NotebookLM Research Assistant

Manim Video Production

PPT Master

Scikit Learn

Related

Questions about Mue