evolve SKILL.md skillA

evolve from sethgammon/citadel is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add sethgammon/citadel/evolve@git:20260611.0f3f8e7

Pins git:20260611.0f3f8e7 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
sethgammon/citadel
Path
skills/evolve/SKILL.md
Versions recorded
5
Latest version
git:20260611.0f3f8e7, committed Jun 11, 2026
First version recorded
May 7, 2026
Size
14,834 bytes
Repository stars
929
License
MIT

Research-driven multi-cycle improvement director. Forms causal hypotheses about why scores are low, validates them with scout agents before attacking, dispatches axis-parallel fleet attacks, extracts transferable patterns, and runs indefinitely within a budget envelope. Accumulates a persistent belief model and pattern library across sessions.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# /evolve — Improvement Director

## Orientation

**Use when:** You want sustained autonomous quality advancement — the director
forms hypotheses, scouts before attacking, and builds a belief model that
compounds across cycles. Runs until a natural ceiling, budget exhaustion, or you
say stop.

**Don't use when:** You want a single scored loop (`/improve`), a known axis
attacked directly (`/improve --axis`), or a one-time audit (`/improve --score-only`).

**Key difference from `/improve`:** `/improve` follows the rubric mechanically.
`/evolve` asks *why* scores are where they are, validates those theories before
spending fleet budget, and extracts cross-skill patterns that propagate to skills
never directly attacked.

## Invocation

```
/evolve {target}                  # run until ceiling, velocity drop, or budget
/evolve {target} --n={N}          # exactly N director cycles then stop
/evolve {target} --budget=${X}    # run until cumulative spend reaches $X
/evolve {target} --continue       # resume from saved director state
/evolve {target} --status         # show belief model, velocity, spend — no attack
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add sethgammon/citadel/evolve@sha256:c9d55a85bcd6c644

The line at the top of this page pins the label git:20260611.0f3f8e7, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_gih33zokedsxgvhp.svg)](https://markdownregistry.com/a/art_gih33zokedsxgvhp)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between May 7, 2026 and Jun 11, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20260611.0f3f8e7 latest2026-06-11 0f3f8e7 14,834 BA view · diff
git:20260611.c8e4cf42026-06-11 c8e4cf4 14,821 BA view · diff
git:20260611.69b50de2026-06-11 69b50de 14,910 BA view · diff
git:20260611.a6479532026-06-11 a647953 14,653 BA view · diff
git:20260507.2a8c1ae2026-05-07 2a8c1ae 14,412 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14834 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

sethgammon/citadel · 929 stars · license MIT · pushed 2026-10-30 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_gih33zokedsxgvhp
GET https://markdownregistry.com/api/v1/resolve?ref=sethgammon/citadel/evolve
GET https://markdownregistry.com/api/v1/blob/c9d55a85bcd6c644c2d9589ddb42cad04e7a2ac6e038e5c1df79f98518aa2b47

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from sethgammon/citadel

AGENTS.md AGENTS.md file
sethgammon/citadel · AGENTS.md
git:20260911.5005453 · audit A · 929 stars
CLAUDE.md CLAUDE.md file
sethgammon/citadel · CLAUDE.md
git:20260911.5005453 · audit A · 929 stars
AGENTS.md@examples/berman-agents-md-only AGENTS.md file
sethgammon/citadel · examples/berman-agents-md-only/AGENTS.md
git:20260701.7169885 · audit A · 929 stars
AGENTS.md@examples/berman-deploy-steward AGENTS.md file
sethgammon/citadel · examples/berman-deploy-steward/AGENTS.md
git:20260701.7169885 · audit A · 929 stars
template-skill SKILL.md skill
sethgammon/citadel · scripts/fixtures/ecosystem/anthropics-template-skill/SKILL.md · Replace with description of the skill and when Claude should use it.
git:20260711.59dbe65 · audit B · 929 stars
architect SKILL.md skill
sethgammon/citadel · skills/architect/SKILL.md · Given a PRD, produces an implementation architecture: file tree, component breakdown, data model, and a phased build…
git:20260611.0f3f8e7 · audit A · 929 stars
archon SKILL.md skill
sethgammon/citadel · skills/archon/SKILL.md · Autonomous multi-session campaign agent. Decomposes large work into phases, delegates to sub-agents, reviews output…
git:20261021.eead012 · audit A · 929 stars
ascii-diagram SKILL.md skill
sethgammon/citadel · skills/ascii-diagram/SKILL.md · Generate perfectly aligned ASCII diagrams — architecture, flow, sequence, box-and-arrow. Uses a programmatic…
git:20260611.0f3f8e7 · audit A · 929 stars
autopilot SKILL.md skill
sethgammon/citadel · skills/autopilot/SKILL.md · Intake-to-delivery pipeline. Processes pending items from .planning/intake/: briefs new ideas, executes approved work…
git:20261009.7a64c3f · audit A · 929 stars
cost SKILL.md skill
sethgammon/citadel · skills/cost/SKILL.md · Deep cost exploration and transparency. Shows real token usage, session costs, campaign spend, burn rates, and model…
git:20260611.0f3f8e7 · audit A · 929 stars
create-app SKILL.md skill
sethgammon/citadel · skills/create-app/SKILL.md · End-to-end app creation from a single description. Five tiers: blank project, guided, templated, fully generated, or…
git:20260611.0f3f8e7 · audit A · 929 stars
create-skill SKILL.md skill
sethgammon/citadel · skills/create-skill/SKILL.md · Creates new skills from the user's repeating patterns. Interview-driven: discovers the task, analyzes failure modes…
git:20260922.465c020 · audit A · 929 stars

Every file in sethgammon/citadel

Other files named evolve

evolve SKILL.md skill
danmcinerney/orchflows · example-workflows/evolve/skills/evolve/SKILL.md · Iteratively improve any artifact and its improvement harness, inventing evaluation when needed; supports bounded runs…
git:20260923.9d51df1 · audit A · 125 stars
evolve SKILL.md skill
kanevry/session-orchestrator · skills/evolve/SKILL.md · Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session…
git:20261021.728a583 · audit A · 52 stars
evolve SKILL.md skill
kanevry/session-orchestrator · .cursor/skills/evolve/SKILL.md · Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session…
git:20260916.3ebf0e9 · audit A · 52 stars
evolve SKILL.md skill
kanevry/session-orchestrator · .agents/skills/evolve/SKILL.md · Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session…
git:20260919.176b605 · audit A · 52 stars
evolve SKILL.md skill
kanevry/session-orchestrator · .codex-plugin/skills/evolve/SKILL.md · Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session…
git:20260918.20a4cbf · audit A · 52 stars
evolve SKILL.md skill
mycelium-hq/ai-brain-starter · skills/evolve/SKILL.md · Use when many related hardened instincts (high-confidence feedback_*/discovery_* memories) have piled up in one domain…
git:20260722.7893e72 · audit A · 50 stars
evolve SKILL.md skill
lstr-1/skills · sex/skills/evolve/SKILL.md · Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session…
git:20260922.11fdbec · audit A · 2 stars
evolve SKILL.md skill
tonygorb/skills · skills/evolve/SKILL.md · Audit one part of the code and rank what to improve. Changes nothing. Use when the user asks "is this outdated" or "how…
git:20261013.bc9e437 · audit A · 2 stars

Browse by kind, by grade A, or by owner.