evoclaude

Agent self-evolution plugin for Claude Code.

🇨🇳 中文

Why EvoClaude • Quick Start • How It Works • Configuration • Development • License

---

Why EvoClaude?

After using Claude Code for a while, you might notice that past experiences cannot be reused in the next task, and Claude Code continues to make the same mistakes. EvoClaude enables Claude Code agents to learn from their experiences and continuously improve through Agent Skills technology. We believe Agent Skills is the right answer to Agent self-evolution!

---

EvoClaude enables Claude Code agents to learn from their experiences and automatically generate reusable skills from patterns in your workflow. The more you use it, the smarter it gets.

---

Quick Start

Start a new Claude Code session in the terminal and enter the following commands:

/plugin marketplace add L-Qun/EvoClaude

/plugin install evoclaude

Restart Claude Code. EvoClaude will automatically start learning from your sessions.

Key Features:

• 🧠 Automatic Learning - Captures patterns from your Claude Code sessions
• 🛠️ Skill Generation - Automatically creates reusable skills from discovered patterns
• 📈 Progressive Improvement - Gets smarter as it accumulates more experience
• 🔍 Pattern Discovery - Identifies recurring workflows and tool combinations
• ⚙️ Fully Configurable - Fine-grained control over learning behavior
• 🚀 Zero Configuration - Works out of the box with sensible defaults

---

How It Works

EvoClaude learns from your sessions in two simple phases:

1. Collection Phase

Each session, EvoClaude captures and stores daily session data:

• Your prompts and instructions
• Tools used (Read, Edit, Grep, Bash, etc.)
• The sequence of operations
• Results and outcomes

Sessions are organized by date: ~/.evoclaude/sessions/YYYY-MM-DD.json

2. Skill Generation Phase

When triggered (daily or manually):

1. Analyze today's sessions for reusable patterns
2. Generate skills following the official Claude Skills format (avoiding semantically duplicates)
3. Merge with existing skills, removing duplicates
4. Package skills into .skill files ready for use

Example Workflow

If you worked on error handling today, EvoClaude will:

1. Collect all your error handling related tasks from today's sessions
2. Analyze the approaches and patterns you used
3. Generate an error-handler skill following the official format
4. Merge it with your existing skills (avoiding duplicates)
5. Make it available in all future sessions

---

Configuration

Settings File

Edit ~/.evoclaude/config.json to customize behavior:

{
  "skillLanguage": "auto",
  "skillsOutputDir": "project"
}

Configuration Options

skillLanguage (enum)

• Language for generated skill content
• Default: "auto"
• Options:
  • "auto" - Automatically detect language from session prompts
  • "en" - Always generate skills in English
  • "zh" - Always generate skills in Chinese

skillsOutputDir (enum)

• Where to save generated skills
• Default: "project"
• Options:
  • "project" - Save skills in the project directory (./project/.claude/skills)
    • Recommended for: Project-specific skills, team-specific workflows
  • "global" - Save skills globally in your home directory (~/.claude/skills)
    • Recommended for: Personal skills shared across all projects

Data Location

~/.evoclaude/
├── config.json           # Your settings
├── sessions/
│   ├── 2026-02-17.json   # Today's session data
│   └── 2026-02-16.json   # Previous day's session data
└── generated/
    └── temp/             # Temporary generated skills

# Skills output (based on skillsOutputDir setting):
./.claude/skills/         # Project-specific skills (default)
~/.claude/skills/         # Global skills (alternative)

---

System Requirements

• Node.js: 18.0.0 or higher
• Claude Code: Latest version with plugin support
• Operating System: macOS, Linux, or Windows

---

Development

Getting Started