# Skill Evolve

> Skill Evolve

- Skill: `zhanghandong/skill-evolve` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add zhanghandong/skill-evolve`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhanghandong/skill-evolve/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ZhangHanDong (https://skillmd.com/u/zhanghandong)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zhanghandong/skill-evolve

---

# Skill Evolve

Automatic skill self-correction system. Monitors plugin tool failures and generates
improvement suggestions for SKILL.md files.

## How It Works

- An `after_tool_call` hook fires on every tool execution
- On failures from plugin tools, the hook identifies the owning skill
- An LLM analyzes the error and suggests a one-line instruction to prevent it
- Suggestions are stored in `evolutions.json` (not applied automatically)
- Use `skill_evolve list` to review pending patches
- Use `skill_evolve apply` to write patches to the skill's SKILL.md

## Commands

- `skill_evolve list` — show all pending evolution patches across skills
- `skill_evolve apply --skill <name>` — apply pending patches to SKILL.md
- `skill_evolve discard --skill <name>` — discard pending patches

