Shelves Architecture & codebase
Refactoring
1,262 rows from 540 repositories
Changing the shape without changing the behaviour.
What Refactoring skills agree on
567 skill files read, by 545 of the 587 authors on this shelf whose files we hold, 2026-09-06
The middle one of the 60 measured here is ~1.2k tokens long, counted with cl100k_base
Counted by distinct author, so one author publishing three of these counts once. Where a claim sits in fewer files than authors, that is said: a claim held by forty authors across three files is one file people copied, not forty people who agreed. Near-identical wordings are grouped and the other wordings are shown, so the grouping is yours to check.
What they tell the agent to do
- Run tests after each change61 of 545 in 59 filesalso worded as Run full test suite after each change; run tests after every single change
- Run tests before refactoring42 of 545also worded as Run tests after each refactoring step; run tests before starting
- Revert immediately if tests fail31 of 545 in 28 filesalso worded as Revert changes immediately if tests fail; Revert changes if tests fail
- Perform refactoring in small steps30 of 545 in 29 filesalso worded as perform refactoring in small reversible steps; Perform refactoring in small incremental steps
- Write characterization tests for untested code21 of 545 in 19 filesalso worded as Write characterization tests before refactoring untested code; Write characterization tests for legacy code
- Remove dead code and unused imports20 of 545also worded as Remove dead code; remove unused exports and commented code
- Identify code smells20 of 545also worded as Identify the code smell; Explain why identified code is a smell
- Perform one refactoring at a time19 of 545also worded as Perform one transformation at a time; Attempt at least one refactoring per cycle
- Commit after each successful refactoring17 of 545 in 15 filesalso worded as Commit each refactoring step separately; Recommend commit and unit test after successful refactoring
- Verify all tests pass after refactoring17 of 545also worded as Verify changes after refactoring; Verify tests pass after each change
- Keep refactoring separate from behavior changes16 of 545 in 14 filesalso worded as commit refactorings separately from behavior changes; keep refactoring and behavior changes separate
- Run the full test suite16 of 545also worded as Run full test suite on the final head; run full test suite and linting
- Separate refactoring from feature work15 of 545 in 14 filesalso worded as keep refactoring separate from feature work; separate refactoring commits from feature commits
- Replace magic values with named constants15 of 545also worded as replace magic numbers with named constants; Replace magic values with constants
- Preserve existing behavior exactly13 of 545also worded as Preserve existing behavior; preserve all existing behavior
What they tell it not to do
- Do not refactor without tests58 of 545 in 56 filesalso worded as Do not refactor without existing tests; do not refactor without test coverage
- Do not change code behavior52 of 545also worded as Do not change existing behavior; Do not change behavior during refactoring
- Do not mix refactoring with behavior changes49 of 545 in 47 filesalso worded as do not mix behavior changes with structural changes; Do not mix refactoring with feature changes
- Do not add new features26 of 545also worded as Do not add features during refactoring; Do not implement new features
- Do not fix bugs during refactoring24 of 545 in 23 filesalso worded as Do not mix refactoring with bug fixes; Do not fix bugs while refactoring
- Do not mix refactoring and feature work in one commit23 of 545 in 22 filesalso worded as Do not mix refactoring with feature development; do not mix refactoring with feature work
- Do not change observable behavior20 of 545also worded as Do not change external behavior; never change observable behavior
- Do not refactor code18 of 545also worded as Do not refactor unrelated code; never refactor code to raise a score
- Do not simplify code you do not understand14 of 545also worded as do not refactor code you do not understand; Do not refactor code you do not fully understand
- Do not skip verification steps13 of 545also worded as do not skip verification; Do not skip the red verification step
What they expect to be installed
- git148 of 545
- grep76 of 545
- test runner41 of 545 in 40 files
- npm25 of 545
- test suite23 of 545
- linter21 of 545
- eslint17 of 545 in 16 files
- bash17 of 545
- ruff16 of 545
- gh16 of 545
What they ask it to produce
- Refactored code106 of 545 in 101 filesalso worded as Refactored source code; Refactored codebase
- Characterization tests48 of 545 in 47 filesalso worded as Characterisation tests; Characterization test
- Refactoring plan43 of 545also worded as refactoring report; Refactor plan
- Refactor report19 of 545also worded as Refactor Guard Report; refactor summary report
- Updated documentation16 of 545 in 14 filesalso worded as Updated project documentation; updated architecture documentation
- Failing test13 of 545also worded as failing-then-passing test; Test files that fail
- Test results12 of 545 in 10 filesalso worded as test execution results; Search results
- Verification results12 of 545also worded as Test verification results; Verification test results
When Refactoring authors say to reach for one
The situations these authors wrote into their own files, counted out of the same 545 authors, with the skills that name each one
- User asks to refactor code69 of 545
- Oma refactor
- Tdd refactor guard
- Refactor safely
- Refactor
- Refactoring
- Improve codebase architecture
- and 7 more on this shelf
- Refactor51 of 545
- Zero tech debt
- Clean code
- Notebook ml architect
- Code discipline
- and 2 more on this shelf
- User asks to clean up code40 of 545
- Refactor safely
- Code simplify
- Refactor
- Refactoring
- Kanso refactor
- Simplify code
- and 2 more on this shelf
- User mentions technical debt25 of 545 in 22 files
- Tech debt tracker
- Oma refactor
- Cto advisor
- Refactoring
- Boy scout rule
- Refactor safely
- and 6 more on this shelf
- Simplify24 of 545
- Zero tech debt
- Clean code
- Simplify
- Code health audit
- and 2 more on this shelf
- Clean up18 of 545
- Zero tech debt
- Clean code
- Code discipline
- and 2 more on this shelf
- Tech debt18 of 545
How Refactoring skills are built
1,123 skill directories by 516 authors, read from their repositories’ own file trees 2026-08-05
The middle bundle among those shipping files is 2 files, 11.0 KB beside SKILL.md
Counted by distinct author, same as above, so one author publishing forty template copies counts once. SKILL.md itself is not counted as a file, so a single-file skill is one where that file is the whole skill.
The shape
- SKILL.md is the whole skill245 of 516 authors, 619 of 1,123 skills
- files ship beside it271 of 516 authors, 504 of 1,123 skills
- executable scripts ship inside54 of 516 authors, 80 of 1,123 skills
The folders they converge on
- references/147 of 516 authors, 250 of 1,123 skills
- agents/60 of 516 authors, 93 of 1,123 skills
- scripts/49 of 516 authors, 76 of 1,123 skills
- evals/22 of 516 authors, 37 of 1,123 skills
- assets/17 of 516 authors, 21 of 1,123 skills
- examples/12 of 516 authors, 14 of 1,123 skills
softaworks/agent-toolkit/dist/plugins/agent-md-refactor/skills/agent-md-refactor Skill
2,311★ repoA curated collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.
amElnagdy/guard-skills/skills/clean-code-guard Skill
1,154★ repoGuard skills for coding agents, quality gates that catch AI-generated failure modes in code, tests, and docs
FernandoJRR/solidifier/claude-code/plugins/solidifier/skills/solidifier Skill
35★ repoSOLID principles and design patterns for backend code — applied with restraint. Skill for Claude Code, OpenCode, GitHub Copilot, and OpenAI Codex.
fanqingxuan/awesome-skills/skills/code-simplifier Skill
26★ repo热门skills推荐,包括编程以及非编程等各种热门实用的skill
jaywilburn/refactoring-ui-skill/skills/refactoring-ui Skill
24★ repoAgent skill for professional UI design based on Refactoring UI principles. Covers hierarchy, typography, color, spacing, dark mode, forms, accessibility, and animation.
igmarin/rails-agent-skills Skill
22★This is my personal configuration of skills as a Ruby on Rails Dev
esparkman/claude-rubycritic-skill/skills/rubycritic-skill Skill
18★ repoA Claude Code skill for Ruby code quality analysis with RubyCritic
kriscard/Skills/skills/dev/analyze-repo Skill
13★ repoA opinionated collection of agent skills organized by domain: dev, writing, productivity, and knowledge management
ZeroPointRepo/CRHQ-PRDs/skills/code-refactor Skill
no license11★ repoProduction-grade, 10,000+ line PRDs that let AI agents one-shot entire applications. Built on CRHQ.ai.
PierreJanineh/TechDebtMCP/io.github.PierreJanineh/tech-debt-mcp MCP server
7★ repoMCP Server for analyzing technical debt across multiple programming languages
JordanCoin/codingskills/skills/boy-scout-rule Skill
6★ repoCoding principles for Claude Code and AI agents. KISS, DRY, SOLID, YAGNI, separation of concerns, and more. Language-agnostic skills that help agents ship production-quality code.
nijanthan-dev/taxmate-australia/local-skills/codex-simplify Skill
no license6★ repoPrep-only Australian individual tax return plugin and portable skills for Codex, Claude Code, Cowork, and OpenAgentSkill: official ATO source links, GST/BAS and CGT review flags, evidence gaps, and manual myTax/paper/accountant handoff.
Dannykkh/skill-olympus/skills/agent-md-refactor Skill
no license4★ repoTwelve Greek gods. One command. A working SaaS. 98 skills + 49 agents + 13 hooks for Claude Code + Codex CLI + Gemini CLI. Cross-CLI persistent memory, zero-interaction full pipeline (design → build → inspect → test → ship).
ryanelian/crucible-agent-skill/skills/crucible Skill
4★ repoLess code is more. Burn the diff down. Optimize, simplify, and delete bad vibes.
initxy/initxy-skills/skills/ai-native-engineering/gc Skill
4★ repoMake any repo AI native — fewer skills, conventions over steps, so any agent can cold-start, implement, self-verify, and write its decisions back.
markoa/clean-code-skill/skills/clean-code Skill
4★ repoAgent skill for clean code programming standards
marshally/mcp-refactoring/io.github.marshally/mcp-refactoring MCP server
4★ repoMCP server exposing Martin Fowler's refactoring catalog to LLMs with 71+ refactorings
mathisk2095/jko-claude-plugins/plugins/dead-code/skills/dead-code-expert Skill
3★ repoProvide Claude plugins with shared coding guidelines, review checks, and stack-specific skills to keep agents consistent across projects
KAppMaker/KAppMaker-CLI/.claude/skills/kappmaker Skill
no license3★ repoKAppMaker CLI tool that automates mobile app setup — Firebase, App Store Connect, Adapty, signing, publishing, and AI-powered logo/screenshot generation in one workflow.
jmsmrgn/einstein-simplify Skill
3★A Claude Code skill that rewrites technical content so non-technical audiences follow every word, without losing accuracy or depth.
momentmaker/kaijutsu/skills/community/code-simplification Skill
3★ repoWrite your dev workflow once. Run it on any LLM. Open agent skills + multi-model swarm + a local findings store that learns which models you can trust.
rolandbrecht/agent-skills/ast-code-graph Skill
3★ repoA collection of shareable, high-quality AI coding agent skills and workflows. These skills provide structured guidance, recipes, and helper scripts to make LLM agents significantly more effective at complex codebase tasks.
eliranpv11/code-discipline-skills/skills/code-discipline Skill
2★ repoProduction-grade coding methodology for AI coding agents, Claude Code, Cursor, Codex. Six principles to stop overengineering, silent assumptions, and "while I'm here" refactors.
Arcadi4/skills/clean-refactor Skill
no license2★ repoMy agent skills.
ukint-vs/codex-simplify/plugins/code-simplifier/skills/simplify Skill
2★ repoCodex-first post-implementation diff cleanup workflow for changed code and docs.
zivreich/fable-maestro Skill
1★Claude Code skill: quality-first model delegation for Fable 5 - Fable plans and reviews every diff, Opus writes the code, Sonnet runs the errands
Ludovic33Fr/tech-debt-manager Skill
no license1★Skill for analyzing, assessing, and prioritizing technical debt.
OneSpiral/code-autopsy Skill
1★Forensic codebase analysis. 16 diagnostics, health score, architecture map, complexity heatmap, risk matrix — all in one interactive HTML report.
kbelasheuski/ios-architecture-skills/plugin/skills/ios-architect Skill
1★ repoChoose, audit, refactor & migrate iOS app architectures. A Claude Code & Codex agent plus skills.
cheickmec/smellcheck/plugins/python-refactoring/skills/python-refactoring Skill
1★ repoPython code smell detector & refactoring guide — 82 patterns, 55 AST checks, zero dependencies. Works as Agent Skills plugin, PyPI package, GitHub Action, or pre-commit hook.
mrzhangguoguo/oh-my-workbuddy/skills/ai-slop-cleaner Skill
1★ repo1:1 WorkBuddy port of oh-my-codex — 46 catalog-driven skills (30 active + 16 deprecated), bilingual docs.
asmgit/nothing-first/skills/nothing-first Skill
1★ repoThe ultimate optimization of any entity is its absence — the best code is the code that does not exist. An always-on Existence Ladder skill for AI agents.
ForeverSc/ai-handrail Skill
1★Making Legacy Projects Safer for Vibe Coding. AI适老化改造,让老项目更适合 Vibe Coding。
magallon/refactoring-toolkit/refactoring-audit Skill
1★ repoStack-agnostic refactoring audit & execution skills for AI agents
paulnsorensen/skillz-that-grillz/skills/bash-shortening Skill
1★ repoAgent skill repository that don't fit cleanly into any of my other cheese-related repositories
pratyush1712/legacy-support-adjudication-skill/skills/legacy-support-adjudication Skill
1★ repoA professional agent skill for code-review agents that need to decide whether backward-compatibility logic is still required or has become removable technical debt.
CodingCossack/agent-systems/skills/change-with-proof Skill
1★ repoAgent-agnostic software engineering skill for implementation, debugging, testing, refactoring, security boundaries, verification, and code review.
sergii-ziborov/weavatrix-refactor/io.github.sergii-ziborov/weavatrix-refactor MCP server
1★ repoThe refactoring layer of Weavatrix: hash-verified, always-reversible edit plans.
guidefanti/claude-code-dev-guardrails Skill
0★Structured skill for Claude Code that enforces disciplined, product-aware development. 20 anti-patterns, 5-level testing hierarchy, and product thinking framework.
grxkun/scope-guard Skill
0★Stop Claude from touching files you didn't ask it to touch. Vibe-coding creep stopper You ask Claude to fix one bug. It refactors 6 files. This skill makes Claude declare the blast radius before touching anything, get a confirmation, then stay inside it. Pain: "I just wanted to fix the button color" → Claude rewrote your entire component tree
owen-dev-6174/bodhisattva-skills/skills/dead-code-cleaner Skill
0★ repoFree Claude Code skills that see developer suffering and offer wisdom. Loop detection, scope guarding, dead code cleanup.
AmineYagoub/p2d/skills/p2d Skill
0★ repoP2D turns vibe coding into system-aware engineering, saving tokens, time, and money.
DockyardTechlabs/crapquants-skill/crapquants Skill
0★ repoHow crappy is your code? Claude skill that teaches Claude to analyze Python code quality using CRAPQuants: Change Risk Anti-Patterns metrics, and diagnostics from 6 software engineering books. Works in Claude.ai, Claude Code, and the API.
produtoramaxvision/maxvision-utilities/.claude/skills/fallow Skill
no license0★ repoMaxVision's curated Claude Code marketplace — production-grade skills for n8n workflows, Google Tag Manager API, and more.
Swellshinider/janitor/integrations/codex/skills/cleaner Skill
0★ repoBehavior-preserving codebase cleanup: removes dead code, splits oversized files and classes, and merges duplicated logic without changing behavior.
kongyo2/TDD/tdd Skill
0★ repoPr1m4lc0d3/KiSYSTEM/skills/kiss-blast-radius Skill
0★ repoKiSYSTEM - measure twice, cut once. A Claude Code skill bundle that keeps AI-written code clean, modular, and human-readable, enforced from the base of a project.
manman1414/frontend-refactor-skills/skills/behavior-preserving-refactor Skill
0★ repoReact/Vue/TS 前端重构 Agent Skills(行为不变重构、拆文件、绞杀者迁移)
jovd83/principal-audit-refactor Skill
0★Runs severity-ranked engineering audits and executes approval-gated refactors to raise prototype code to production quality.
garrettsiegel/lobstore/.github/skills/refactor Skill
0★ repoVS Code extension to browse and install MoltHub skills for GitHub Copilot without admin access
adryledo/arca-cli/samples/maintainer/skills/python-refactor Skill
0★ repoAsset Resolution for AI Assistants. Use versioned assets declarations instead of commiting full .md files in your repo, host the assets in any git repo
pipi-1997/agent-skills/skills/tsve-refactoring Skill
0★ repoReusable agent skills for AI-assisted development — T-S-V-E refactoring workflow with Code Hollowing
rooftop-Owl/notion-ao-research/skills/notion-ao-bulletin Skill
no license0★ repoAgent-oriented research workflow skills for Notion MCP. NL database operations, workspace setup, design handbook (EN/KO). Works with Claude Code, Cursor, Windsurf, or any MCP client.
deepfriedmind/agent-skills/skills/es-toolkit Skill
0★ repoReusable skills for coding agents.
rerelurelu/skillbox/skills/clean-code Skill
0★ repopeizh/refactor-legacy-code Skill
0★Agent skill for safe legacy-code refactoring and maintenance workflows
s1dd4rth/clean-code Skill
0★A Claude Agent Skill for writing, reviewing, and refactoring code using Robert C. Martin's Clean Code framework.
grahambrooks/gb-agent-skills/plugins/code-intelligence/skills/explore-code Skill
0★ repoClaude Code Plugins
yidasanqian/codex-code-simplifier/plugins/code-simplifier/skills/code-simplifier Skill
0★ repoCodex plugin for simplifying recent code changes without changing behavior
cskwork/clean-code-skill Skill
0★Agent skill for behavior-preserving clean-code refactoring of any codebase, based on Fowler's catalog (refactoring.guru): detect smell -> choose technique -> apply in safe small steps.