Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session history), review (edit/manage existing learnings), list (display active learnings). Manages .orchestrator/metrics/learnings.jsonl.
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
> **Platform Note:** State files use the platform's native directory: `.claude/` (Claude Code), `.codex/` (Codex CLI), or `.cursor/` (Cursor IDE). Shared metrics live in `.orchestrator/metrics/` (v2) with fallback to `<state-dir>/metrics/` for pre-v2.0 legacy data. See `skills/_shared/platform-tools.md`.
# Evolve Skill
## Phase 0: Bootstrap Gate
Read `skills/_shared/bootstrap-gate.md` and execute the gate check. If the gate is CLOSED, invoke `skills/bootstrap/SKILL.md` and wait for completion before proceeding. If the gate is OPEN, continue to Phase 1.
<HARD-GATE>
Do NOT proceed past Phase 0 if GATE_CLOSED. There is no bypass. Refer to `skills/_shared/bootstrap-gate.md` for the full HARD-GATE constraints.
</HARD-GATE>
## Phase 1: Config & Data Loading
### 1.1 Read Session Config
Read and parse Session Config per `skills/_shared/config-reading.md`. Store result as `$CONFIG`.
### 1.2 Check Persistence
Extract `persistence` from `$CONFIG`. If `persistence` is `false`, abort with message:
> "Learnings require persistence to be enabled in Session Config. Add `persistence: true` to your Session Config block (CLAUDE.md for Claude Code, AGENTS.md for Codex CLI)."
…
The line at the top of this page pins the label git:20260922.11fdbec, 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.
GET https://markdownregistry.com/api/v1/artifacts/art_36fllo7dkejpygf3
GET https://markdownregistry.com/api/v1/resolve?ref=lstr-1/skills/evolve
GET https://markdownregistry.com/api/v1/blob/b803509cdb6c97636f504cdcc53000ae670e6d9847a6ea53652bc82afa9fba7e
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.
lstr-1/skills · create-skill/SKILL.md · Use when the user wants to create, design, or generate a new AI agent skill (SKILL.md) from a problem description. This…
lstr-1/skills · monitor-startup-dach/SKILL.md · Fetch the top-25 posts from r/StartupDACH/hot.json, classify each into six deterministic German intent clusters…
lstr-1/skills · nlm-meta-study/SKILL.md · Create scientific meta-studies on any topic using Gemini Notebook (NotebookLM). Invoke for systematic reviews…
lstr-1/skills · orchestrator/skills/architecture/SKILL.md · Use when the user asks to improve architecture, find refactoring opportunities, surface deepening opportunities…
lstr-1/skills · orchestrator/skills/autopilot/SKILL.md · Use this skill when running an autonomous session-orchestration loop. Chains session-start → session-plan →…
lstr-1/skills · orchestrator/skills/bootstrap/SKILL.md · Use this skill when scaffolding the minimum repository structure required by orchestrator. Invoked automatically by the…
lstr-1/skills · orchestrator/skills/brainstorm/SKILL.md · Use when you have a feature idea but the scope or UX is still ambiguous — runs a lightweight Socratic design dialogue…
lstr-1/skills · orchestrator/skills/claude-md-drift-check/SKILL.md · Use when detecting drift between CLAUDE.md (or AGENTS.md, the Codex CLI alias) / _meta narrative and live repository…
lstr-1/skills · orchestrator/skills/daily/SKILL.md · Use this skill when creating today's daily note in the Meta-Vault (03-daily/YYYY-MM-DD.md) with valid…
lstr-1/skills · orchestrator/skills/debug/SKILL.md · Use when encountering any bug, test failure, build break, or unexpected behavior — runs a 4-phase systematic debugging…
sethgammon/citadel · skills/evolve/SKILL.md · Research-driven multi-cycle improvement director. Forms causal hypotheses about why scores are low, validates them with…
danmcinerney/orchflows · example-workflows/evolve/skills/evolve/SKILL.md · Iteratively improve any artifact and its improvement harness, inventing evaluation when needed; supports bounded runs…
kanevry/session-orchestrator · skills/evolve/SKILL.md · Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session…
kanevry/session-orchestrator · .cursor/skills/evolve/SKILL.md · Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session…
kanevry/session-orchestrator · .agents/skills/evolve/SKILL.md · Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session…
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…
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…
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…
