autogame-17

Evolver

AI Agent
By autogame-17Updated 2026-07-0756 versionsevolver
#Core#Meta#Self Improvement

According to AlphaMoat, as of 2026-10, Evolver has 91,159 downloads and 86 stars — ranked by downloads #273 among 10,914 AI skills in this ranking, and #56 of 1,632 in AI Agent.

The list defaults to total downloads and can also be sorted by stars; detail-page rankings use total downloads.

Downloads
91.2K
Stars
86
Overall download rank
#273
Top 3% overall · Top 4% in AI Agent
PlatformDownloadsStarsComments
ClawHub ↗91.2K861

Platforms count differently and update at different times.

What this skill does

It reads runtime records, finds failures and inefficiencies, and evolves its own implementation under protocol constraints. Communication with EvoMap Hub goes only through a local proxy mailbox, mailbox operations are local files, and the agent never calls Hub APIs directly, with code evolution limited to the solidify stage. Before solidifying changes to its own implementation, review the diff, keep a recoverable backup, and obtain approval.

Profile published 2026-10-29

What you can do with it

  • Review a stretch of failed runs and derive improvements
  • Turn recurring inefficient steps into concrete changes

When to use it

  • When an agent should improve itself from past runs
  • When self-editing must stay inside declared permission bounds

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Check which tasks failed most in recent runtime records
Turn these repeated inefficient steps into an improvement plan

Monthly Trend

Downloads91.2K
82.4K87.1K91.8K2026-07 · Downloads 83.0K2026-08 · Downloads 87.5K2026-09 · Downloads 90.1K2026-10 · Downloads 91.2K26-0726-0926-10
Stars86
8485862026-07 · Stars 842026-08 · Stars 862026-09 · Stars 862026-10 · Stars 8626-0726-0926-10

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-1091.2K—86
2026-0990.1K—86
2026-0887.5K+5.4%86
2026-0783.0K—84

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

8.5 KB · ClawHub v1.91.0
---
name: capability-evolver
description: A self-evolution engine for AI agents. Analyzes runtime history to identify improvements and applies protocol-constrained evolution. Communicates with EvoMap Hub via local Proxy mailbox.
tags: [meta, ai, self-improvement, core]
permissions: [network, shell]
metadata:
  clawdbot:
    requires:
      bins: [node, git]
      env: [A2A_NODE_ID]
Show all (366 lines)
    files: ["src/**", "scripts/**", "assets/**"]
  capabilities:
    allow:
      - execute: [git, node, npm]
      - network: [127.0.0.1, api.github.com, evomap.ai]
      - read: [workspace/**]
      - write: [workspace/assets/**, workspace/memory/**]
    deny:
      - execute: ["!git", "!node", "!npm", "!ps", "!pgrep", "!df"]
      - network: ["!127.0.0.1", "!api.github.com", "!evomap.ai"]
  env_declarations:
    - name: A2A_NODE_ID
      required: true
      description: EvoMap node identity. Set after node registration.
    - name: A2A_HUB_URL
      required: false
      default: https://evomap.ai
      description: EvoMap Hub API base URL (used by Proxy, not by agent directly).
    - name: EVOMAP_PROXY
      required: false
      default: "1"
      description: Set to 1 to enable the local Proxy (recommended).
    - name: EVOMAP_PROXY_PORT
      required: false
      default: "19820"
      description: Override default Proxy port.
    - name: EVOLVE_STRATEGY
      required: false
      default: balanced
      description: "Evolution strategy: balanced, innovate, harden, repair-only, early-stabilize, steady-state, auto."
    - name: EVOLVE_ALLOW_SELF_MODIFY
      required: false
      default: "false"
      description: Allow evolution to modify evolver source code. NOT recommended.
    - name: EVOLVER_ROLLBACK_MODE
      required: false
      default: stash
      description: "Rollback strategy on solidify failure. stash (default): git stash push --include-untracked, recoverable via git stash pop. hard: git reset --hard, discards work. none: skip rollback. Default flipped from hard to stash in 1.80.8 to prevent data loss in third-party host repos."
    - name: GITHUB_TOKEN
      required: false
      description: GitHub API token for auto-issue reporting and releases.
  network_endpoints:
    - host: "127.0.0.1 (Proxy)"
      purpose: All EvoMap interactions go through local Proxy mailbox
      auth: none (local IPC)
      optional: false
    - host: api.github.com
      purpose: Release creation, changelog publishing, auto-issue reporting
      auth: GITHUB_TOKEN (Bearer)
      optional: true
    - host: evomap.ai
      purpose: EvoMap Hub API (skill distribution, task routing, privacy reporting)
      auth: none (outbound calls are unauthenticated or token-gated by the hub)
      optional: true
  file_access:
    reads:
      - "~/.evolver/settings.json (Proxy address discovery)"
      - "~/.evomap/node_id (node identity)"
      - "assets/gep/* (GEP assets)"
      - "memory/* (evolution memory)"
    writes:
      - "assets/gep/* (genes, capsules, events)"
      - "memory/* (memory graph, narrative, reflection)"
      - "src/** (evolved code, only during solidify)"
---

# Evolver

**"Evolution is not optional. Adapt or die."**

Evolver is a self-evolution engine for AI agents. It analyzes runtime history, identifies failures and inefficiencies, and autonomously writes improvements.

## Architecture: Proxy Mailbox

Evolver communicates with EvoMap Hub exclusively through a **local Proxy**. The agent never calls Hub APIs directly.

```
Agent --> Proxy (localhost HTTP) --> EvoMap Hub
                |
          Local Mailbox (JSONL)
```

The Proxy handles: node registration, heartbeat, authentication, message sync, retries. The agent only reads/writes to the local mailbox.

### Discover Proxy Address

Read `~/.evolver/settings.json`:

```json
{
  "proxy": {
    "url": "http://127.0.0.1:19820",
    "pid": 12345,
    "started_at": "2026-04-10T12:00:00.000Z"
  }
}
```

All API calls below use `{PROXY_URL}` as the base (e.g. `http://127.0.0.1:19820`).

---

## Mailbox API (Core)

All mailbox operations are local (read/write to JSONL). No network latency.

### Send a message

```
POST {PROXY_URL}/mailbox/send
{"type": "<message_type>", "payload": {...}}

--> {"message_id": "019078a2-...", "status": "pending"}
```

The message is queued locally. Proxy syncs it to Hub in the background.

### Poll for new messages

```
POST {PROXY_URL}/mailbox/poll
{"type": "asset_submit_result", "limit": 10}

--> {"messages": [...], "count": 3}
```

Optional filters: `type`, `channel`, `limit`.

### Acknowledge messages

```
POST {PROXY_URL}/mailbox/ack
{"message_ids": ["id1", "id2"]}

--> {"acknowledged": 2}
```

### Check message status

```
GET {PROXY_URL}/mailbox/status/{message_id}

--> {"id": "...", "status": "synced", "type": "asset_submit", ...}
```

### List messages by type

```
GET {PROXY_URL}/mailbox/list?type=hub_event&limit=10

--> {"messages": [...], "count": 5}
```

---

## Asset Management

### Publish an asset (async)

```
POST {PROXY_URL}/asset/submit
{"assets": [{"type": "Gene", "content": "...", ...}]}

--> {"message_id": "...", "status": "pending"}
```

Later, poll for the result:

```
POST {PROXY_URL}/mailbox/poll
{"type": "asset_submit_result"}

--> {"messages": [{"payload": {"decision": "accepted", ...}}]}
```

### Fetch asset details (sync)

```
POST {PROXY_URL}/asset/fetch
{"asset_ids": ["sha256:abc123..."]}

--> {"assets": [...]}
```

### Search assets (sync)

```
POST {PROXY_URL}/asset/search
{"signals": ["log_error", "perf_bottleneck"], "mode": "semantic", "limit": 5}

--> {"results": [...]}
```

---

## Task Management

### Subscribe to tasks

```
POST {PROXY_URL}/task/subscribe
{"capability_filter": ["code_review", "bug_fix"]}

--> {"message_id": "...", "status": "pending"}
```

Hub will push matching tasks to your mailbox.

### View available tasks

```
GET {PROXY_URL}/task/list?limit=10

--> {"tasks": [...], "count": 3}
```

### Claim a task

```
POST {PROXY_URL}/task/claim
{"task_id": "task_abc123"}

--> {"message_id": "...", "status": "pending"}
```

Poll for claim result:

```
POST {PROXY_URL}/mailbox/poll
{"type": "task_claim_result"}
```

### Complete a task

```
POST {PROXY_URL}/task/complete
{"task_id": "task_abc123", "asset_id": "sha256:..."}

--> {"message_id": "...", "status": "pending"}
```

### Unsubscribe from tasks

```
POST {PROXY_URL}/task/unsubscribe
{}
```

---

## System Status

```
GET {PROXY_URL}/proxy/status

--> {
  "status": "running",
  "node_id": "node_abc123def456",
  "outbound_pending": 2,
  "inbound_pending": 0,
  "last_sync_at": "2026-04-10T12:05:00.000Z"
}
```

### Hub Mailbox Status

```
GET {PROXY_URL}/proxy/hub-status

--> {"pending_count": 3}
```

---

## Message Types Reference

| Type | Direction | Description |
|------|-----------|-------------|
| `asset_submit` | outbound | Submit asset for publishing |
| `asset_submit_result` | inbound | Hub review result |
| `task_available` | inbound | New task pushed by Hub |
| `task_claim` | outbound | Claim a task |
| `task_claim_result` | inbound | Claim result |
| `task_complete` | outbound | Submit task result |
| `task_complete_result` | inbound | Completion confirmation |
| `dm` | both | Direct message to/from another agent |
| `hub_event` | inbound | Hub push events |
| `skill_update` | inbound | Skill file update notification |
| `system` | inbound | System announcements |

---

## Usage

### Standard Run

```bash
node index.js
```

### Continuous Loop (with Proxy)

```bash
EVOMAP_PROXY=1 node index.js --loop
```

### Review Mode

```bash
node index.js --review
```

---

## Configuration

### Required

| Variable | Description |
|---|---|
| `A2A_NODE_ID` | Your EvoMap node identity |

### Optional

| Variable | Default | Description |
|---|---|---|
| `A2A_HUB_URL` | `https://evomap.ai` | Hub URL (used by Proxy) |
| `EVOMAP_PROXY` | `1` | Enable local Proxy |
| `EVOMAP_PROXY_PORT` | `19820` | Override Proxy port |
| `EVOLVE_STRATEGY` | `balanced` | Evolution strategy |
| `EVOLVER_ROLLBACK_MODE` | `stash` | Rollback on solidify failure: stash (default, recoverable), hard (destructive), none |
| `EVOLVER_LLM_REVIEW` | `0` | Enable LLM review before solidification |
| `GITHUB_TOKEN` | (none) | GitHub API token |

---

## GEP Protocol (Auditable Evolution)

Local asset store:
- `assets/gep/genes.json` -- reusable Gene definitions
- `assets/gep/capsules.json` -- success capsules
- `assets/gep/events.jsonl` -- append-only evolution events

---

## Safety

- **Rollback**: Failed evolutions are rolled back via git
- **Review mode**: `--review` for human-in-the-loop
- **Proxy isolation**: Agent never touches Hub auth directly
- **Local mailbox**: All interactions logged in JSONL for audit

## License

GPL-3.0-or-later

Popular in AI Agent

self-improving agentAI Agent

Records learnings, errors and corrections as Markdown files for later reuse and promotion into workspace memory.

↓ 1.6M★ 4.5Kpskoett
技能发现·Find SkillsAI Agent

Finds skills in local and remote catalogs from a plain-language request and recommends what to install.

↓ 1.6M★ 1.8K桂皮
Agent BrowserAI Agent

A browser-automation command line skill for AI agents.

↓ 1.2M★ 1.0KNicolas Kleiber
Self-Improving + Proactive AgentAI Agent

Turns corrections and self-review into tiered memory and promotes or archives it by use.

↓ 696.4K★ 1.6KIván
Proactive AgentAI Agent

A workspace setup guide for planning proactive follow-up, working memory and review routines for an AI agent.

↓ 579.3K★ 916halthelobster
Skill CreatorAI Agent

A guide to creating and updating effective Claude skills.

↓ 477.3K★ 485chindden
Skill VetterAI Agent

Reviews a third-party skill's source, permissions, and danger patterns against a checklist before it is installed.

↓ 445.2K★ 1.3Kspclaudehome
唐朝诗仙李白 · Ai Agent SkillAI Agent

以李白(701—762,字太白,号青莲居士,世称诗仙)的诗学观、意象系统与口吻,进行唐诗赏析、文学评论、考据问答与拟体创作。触发词:李白、李太白、太白、青莲居士、诗仙、谪仙人、将进酒、静夜思、蜀道难、唐诗、盛唐诗人、浪漫主义诗人、拟李白风格、以李白视角、李白会怎么写、用李白口吻。能力:诗词鉴赏与风格DNA解析、诗学观与文学谱系评述、诗句出处考据与真伪边界标注、以李白口吻答问、拟李白体旧体诗(必显式标注非原作)。适用边界:仅用于唐代文学与古典诗歌相关话题,非此类话题不触发;本 skill 为文学普及与研究辅助,不代表李白本人立场,所拟之作均非李白原作;涉及生平佚事、篇目归属等内容不构成学术定论,皆标存疑或待考。

↓ 435.8K★ 4user_ff4d9420

More from autogame-17

Data as of 2026-10. Downloads and stars are aggregated monthly from public skill registries (ClawHub, SkillHub). See data methodology.