refactor SKILL.md skillA

refactor 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/refactor@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/refactor/SKILL.md
Versions recorded
4
Latest version
git:20260611.0f3f8e7, committed Jun 11, 2026
First version recorded
Mar 29, 2026
Size
8,263 bytes
Repository stars
929
License
MIT

Safe multi-file refactoring with automatic rollback. Establishes a type/test baseline, plans all changes, executes file-by-file, and verifies zero regressions. Reverts if verification fails after two fix attempts. Handles renames, extracts, moves, splits, merges, and inlines.

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

# /refactor — Safe Multi-File Refactoring

## Orientation

Use `/refactor` when you need to:
- Rename a symbol, file, or module across the codebase
- Extract a function, component, hook, class, or module from existing code
- Inline a function or module back into its callers
- Move a file or set of files to a new location
- Split a large file into smaller pieces
- Merge related files into one
- Change a function signature and update all call sites

**Don't use when:** debugging a specific bug (use /systematic-debugging); adding new features (use /marshal or /scaffold); deleting dead code (use /marshal for a targeted cleanup).

**Boundary with /organize:** /refactor changes code structure within files (extract, inline, split, merge, rename) and moves files as part of those operations. Repository-wide file/directory placement, naming sweeps, and where-does-this-belong decisions are /organize.

**Behavior does not change.** Tests pass before and after, no new type errors — the refactoring is correct.

## Commands

| Command | Behavior |
|---|---|
| `/refactor rename [old] to [new]` | Rename symbol, file, or module |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add sethgammon/citadel/refactor@sha256:498345115efe97e7

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

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

Versions

The registry has recorded 4 versions of this file, between Mar 29, 2026 and Jun 11, 2026, about one every 25 days.

versioncommittedcommitsizeaudit
git:20260611.0f3f8e7 latest2026-06-11 0f3f8e7 8,263 BA view · diff
git:20260611.3d0afc42026-06-11 3d0afc4 8,250 BA view · diff
git:20260503.631b94d2026-05-03 631b94d 7,980 BA view · diff
git:20260329.6c378a22026-03-29 6c378a2 10,035 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 (8263 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_wshicfg7viyrbv7n
GET https://markdownregistry.com/api/v1/resolve?ref=sethgammon/citadel/refactor
GET https://markdownregistry.com/api/v1/blob/498345115efe97e7f932b487aec0feb802b907aac93ad51a9785a83878c0d6fa

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 refactor

refactor SKILL.md skill
code-yeongyu/oh-my-openagent · packages/shared-skills/skills/refactor/SKILL.md · Guides a refactor, cleanup, or restructure with the right decomposition. Use when the user asks to refactor, simplify…
git:20261023.af359db · audit A · 70,648 stars
refactor SKILL.md skill
dcouple/pane · main/src/services/paneChatBundle/skills/refactor/SKILL.md · Post-PR refactor pass. Sizes the diff against the remote default branch, fans out refactor-simple (and refactor-deep on…
git:20260924.c3bd4b5 · audit A · 601 stars
refactor SKILL.md skill
greenfield-inc/pane · main/src/services/paneChatBundle/skills/refactor/SKILL.md · Post-PR refactor pass. Sizes the diff against the remote default branch, fans out refactor-simple (and refactor-deep on…
git:20260924.c3bd4b5 · audit A · 600 stars
refactor SKILL.md skill
rsmdt/the-startup · plugins/start/skills/refactor/SKILL.md · Refactor, simplify, or clean up code for improved maintainability without changing business logic
git:20261011.48bd3ee · audit A · 577 stars
refactor SKILL.md skill
boshu2/agentops · skills/refactor/SKILL.md · Restructure or clean up code with no behavior change, proved by before-and-after checks. Use when: asked to clean up…
git:20261021.71bc1e4 · audit A · 450 stars
refactor SKILL.md skill
boshu2/agentops · plugin/skills/refactor/SKILL.md · Restructure or clean up code with no behavior change, proved by before-and-after checks. Use when: asked to clean up…
git:20261026.1b5f59a · audit A · 450 stars
refactor SKILL.md skill
justxor/claude-code-pro-course · starter-kit/.claude/skills/refactor/SKILL.md · Безопасный рефакторинг маленькими шагами без изменения поведения. Используй, когда просят отрефакторить, упростить…
git:20260930.76c4189 · audit A · 334 stars
refactor SKILL.md skill
testdouble/han · han-coding/skills/refactor/SKILL.md · Restructure existing code without changing its behavior, through a test-gated refactoring loop: a named target, a green…
git:20260915.ec2cb7c · audit A · 334 stars

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