improve SKILL.md skillA

improve 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/improve@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/improve/SKILL.md
Versions recorded
5
Latest version
git:20260611.0f3f8e7, committed Jun 11, 2026
First version recorded
Jun 11, 2026
Size
17,091 bytes
Repository stars
929
License
MIT

Autonomous quality improvement loop. Scores a target against a rubric, selects the highest-leverage axis, attacks it, verifies, documents, and loops. No pre-planning between iterations — each loop re-scores from scratch.

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

# /improve — Autonomous Quality Engine

## Orientation

**Use when:** Scoring a target against a rubric and iteratively improving it. Rubric required at `.planning/rubrics/{target}.md` (Phase 0 creates one if missing).

**Don't use when:** Refactoring without a rubric (use `/refactor`), one-time code review (use `/review`), or debugging a specific bug (use `/systematic-debugging`).

## Invocation

```
/improve {target}            # Loop until plateau or all axes >= 8.0
/improve {target} --n=3      # Run exactly N loops then stop
/improve {target} --axis={name}  # Force-attack a specific axis (skips scoring)
/improve {target} --score-only   # Score and report, no attack
/improve {target} --continue     # Resume from campaign state (used by daemon)
/improve citadel             # Targets Citadel itself
```

`target` is a slug that maps to `.planning/rubrics/{target}.md`.
If no rubric exists, run Phase 0 first.

## Campaign Mode

When invoked with `--n` or `--continue`, improve operates in **campaign mode** and maintains a campaign file that daemon can attach to.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add sethgammon/citadel/improve@sha256:ae411ed3352d4a11

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_7ccd5w6khs3gfg3m.svg)](https://markdownregistry.com/a/art_7ccd5w6khs3gfg3m)

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

Versions

The registry has recorded 5 versions of this file, all committed on Jun 11, 2026.

versioncommittedcommitsizeaudit
git:20260611.0f3f8e7 latest2026-06-11 0f3f8e7 17,091 BA view · diff
git:20260611.c8e4cf42026-06-11 c8e4cf4 17,078 BA view · diff
git:20260611.a25e2642026-06-11 a25e264 18,146 BA view · diff
git:20260611.69b50de2026-06-11 69b50de 18,149 BA view · diff
git:20260611.a6479532026-06-11 a647953 17,845 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 (17091 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_7ccd5w6khs3gfg3m
GET https://markdownregistry.com/api/v1/resolve?ref=sethgammon/citadel/improve
GET https://markdownregistry.com/api/v1/blob/ae411ed3352d4a11a154f342723c0b1048cb03faf0b00ba1e0779ef8e0223830

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 improve

improve SKILL.md skill
rsmdt/the-startup · plugins/start/skills/improve/SKILL.md · Find deepening opportunities in a codebase — refactors that turn shallow modules into deep ones for better testability…
git:20260930.f2ff895 · audit A · 577 stars
improve SKILL.md skill
asymmetric-al/core · .agents/skills/improve/SKILL.md · Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER…
v1.0.0 · audit B · 373 stars
improve SKILL.md skill
coder/agent-tty · .agents/skills/improve/SKILL.md · Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER…
v1.0.0 · audit B · 30 stars
improve SKILL.md skill
jim60105/copilot-prompt · skills/improve/SKILL.md · Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER…
v1.0.0 · audit B · 22 stars
improve SKILL.md skill
khaledsaeed18/dotclaude · .agents/skills/improve/SKILL.md · Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER…
v1.0.0 · audit B · 5 stars

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