Agent skill

Refactoring

by ciembor in ciembor/agent-rules-books

Apply Martin Fowler-inspired refactoring rules when improving existing code structure while preserving observable behavior.

MITAuto-check passedDevelopment

Install Refactoring

skills CLI
$ npx skills add ciembor/agent-rules-books --skill refactoring -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ciembor/agent-rules-books refactoring --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ciembor/agent-rules-books.git skills-src && mkdir -p .claude/skills && cp -r skills-src/refactoring .claude/skills/refactoring && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
refactoring
GitHub stars
2.9k
Token cost
~154 tokens
SKILL.md length
54 words
Files
4
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Apply Martin Fowler-inspired refactoring rules when improving existing code structure while preserving observable behavior.

  • Tasks that involve Refactoring
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Agent instruction files

What it does

Refactoring is an agent skill from ciembor/agent-rules-books. Apply Martin Fowler-inspired refactoring rules when improving existing code structure while preserving observable behavior.

Its SKILL.md is about 150 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `refactoring.md`, `refactoring.mini.md` and `refactoring.nano.md`).

It sits in Development, covering Refactoring and Agent instruction files. The repository describes itself as: AGENTS.md rules / skills for AI coding agents: Codex, Cursor & Claude Code. Inspired by Clean Code, Refactoring, DDD, Clean Architecture and DDIA programming books. The licence is MIT.

When your agent uses it

  • Tasks that involve Refactoring
  • Tasks that involve Agent instruction files

Example prompts

  • “/refactoring”

What it can do on your machine

Read from SKILL.md and the folder at commit 893a88a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Refactoring loads about 154 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 54 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~154

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ciembor/agent-rules-books at commit 893a88a, republished under its MIT licence (© ciembor). 54 words, ~154 tokens.

Download SKILL.mdSave it as .claude/skills/refactoring/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
refactoring
description
Apply Martin Fowler-inspired refactoring rules when improving existing code structure while preserving observable behavior.
license
MIT

Refactoring Skill

Use this skill when a task involves behavior-preserving code improvement, code smells, small refactoring steps, test-backed cleanup, or separating refactoring from feature changes.

Before making design or code decisions, read and apply refactoring.mini.md. Use refactoring.md only as a deeper reference when the mini rules are not enough for the current refactoring tradeoff.

© ciembor, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in refactoring of ciembor/agent-rules-books.

  • SKILL.md
  • refactoring.md
  • refactoring.mini.md
  • refactoring.nano.md

Open the folder on GitHubat commit 893a88a

Compare with similar skills

Refactoring next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Refactoring compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Refactoring this skillciembor/agent-rules-books2.9k—~154Automated safety check: PassMIT
Ss Cpp ModernSerial-Studio/Serial-Studio7.2k—~1.6kAutomated safety check: PassCustom licence
Go Rigmudrii/openclaw-dashboard458—~2.8kAutomated safety check: PassMIT
Go Rigmudrii/openclaw-dashboard458—~682Automated safety check: PassMIT
Py Rigmudrii/hermesd119—~6.3kAutomated safety check: PassMIT
Rnd Code Simplifychendongqi/OPB-Skills125—~2.2kAutomated safety check: PassNone

Similar skills

  • Ss Cpp Modern

    Serial-Studio/Serial-Studio

    Modern C++20 authoring guidance for Serial Studio (Qt 6.11, C++20): concepts, ranges, move/RAII, std smart pointers, constexpr, lock-free SPSC atomics.

    7.2k GitHub stars~1.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Go Rig

    mudrii/openclaw-dashboard

    A skill your agent uses when building, reviewing, or refactoring Go code that must follow strict design discipline — ATDD/TDD workflow, explicit dependency injection, package-boundary discipline…

    458 GitHub stars~2.8k tokensUpdated 14 days ago
    DevelopmentAuto-check passed
  • Go Rig

    mudrii/openclaw-dashboard

    A skill your agent uses when building, reviewing, or refactoring Go code in this repository.

    458 GitHub stars~682 tokensUpdated 14 days ago
    DevelopmentAuto-check passed
  • Py Rig

    mudrii/hermesd

    A skill your agent uses when building, reviewing, or refactoring Python code that requires strong maintainability discipline: SRP, DRY, OCP, explicit dependency injection, TDD/ATDD workflow, strict…

    119 GitHub stars~6.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Rnd Code Simplify

    chendongqi/OPB-Skills

    Expert code simplification and refactoring specialist that autonomously enhances code clarity, consistency, and maintainability while preserving exact functionality.

    125 GitHub stars~2.2k tokensUpdated 7 mo ago
    DevelopmentAuto-check passed
  • Safe Remove

    sd0xdev/sd0x-harness

    Safely remove plugin assets (skill/agent/rule/script/hook) with dependency detection and reference cleanup.

    192 GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed

More from ciembor/agent-rules-books

All 14 skills in this repo
  • Apply Martin Fowler-inspired enterprise architecture rules when choosing layers, service layers, transaction scripts, domain models, repositories, mappers, or…

    2.9k GitHub stars~228 tokensUpdated 27 days ago
    Auto-check passed
  • A Philosophy of Software Design

    ciembor/agent-rules-books

    Apply John Ousterhout-inspired software design rules when reducing complexity, designing module boundaries, or reviewing APIs and abstractions.

    2.9k GitHub stars~181 tokensUpdated 27 days ago
    Auto-check passed
  • Clean Architecture Rules

    ciembor/agent-rules-books

    Apply Robert C. Martin-inspired architecture rules when separating business policy from frameworks, databases, UI, or infrastructure details.

    2.9k GitHub stars~166 tokensUpdated 27 days ago
    Auto-check passed
  • Clean Code Rules

    ciembor/agent-rules-books

    Apply Robert C. Martin-inspired clean code rules when improving readability, naming, function design, responsibilities, or testable everyday code.

    2.9k GitHub stars~154 tokensUpdated 27 days ago
    Auto-check passed
  • Code Complete Construction Rules

    ciembor/agent-rules-books

    Apply Steve McConnell-inspired construction rules when implementing routines, variables, classes, control flow, defensive code, or tests.

    2.9k GitHub stars~165 tokensUpdated 27 days ago
    Auto-check passed
  • Data-Intensive Design Rules

    ciembor/agent-rules-books

    Apply Martin Kleppmann-inspired data-system rules when designing reliability, scalability, consistency, replication, transactions, streams, or schema evolution.

    2.9k GitHub stars~206 tokensUpdated 27 days ago
    Auto-check passed

Categories

Questions about Refactoring

What does Refactoring do?

Apply Martin Fowler-inspired refactoring rules when improving existing code structure while preserving observable behavior. Refactoring is an agent skill from ciembor/agent-rules-books. Apply Martin Fowler-inspired refactoring rules when improving existing code structure while preserving observable behavior.

When should I use Refactoring?

Refactoring fits situations like: tasks that involve Refactoring; tasks that involve Agent instruction files.

How do I install Refactoring in Claude Code?

Run `npx skills add ciembor/agent-rules-books --skill refactoring -a claude-code`. Or copy the skill folder (refactoring in ciembor/agent-rules-books) into .claude/skills/refactoring in your project. Claude Code loads it when a task matches its description.

How do I install Refactoring in Codex?

Run `npx skills add ciembor/agent-rules-books --skill refactoring -a codex`. Or copy the skill folder (refactoring in ciembor/agent-rules-books) into .agents/skills/refactoring in your project. Codex loads it when a task matches its description.

Can I use Refactoring in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ciembor/agent-rules-books --skill refactoring -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/refactoring, .gemini/skills/refactoring, .github/skills/refactoring and .opencode/skills/refactoring in your project.

What does Refactoring need to run?

SKILL.md names no scripts, command-line tools or credentials: Refactoring is instructions for the agent only.

Does Refactoring access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Refactoring safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Refactoring use?

Refactoring is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Refactoring use?

About 154 tokens (SKILL.md is roughly 616 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Refactoring?

Skills that share tags, products or a category with Refactoring: Ss Cpp Modern (Serial-Studio/Serial-Studio, 7.2k stars), Go Rig (mudrii/openclaw-dashboard, 458 stars), Go Rig (mudrii/openclaw-dashboard, 458 stars) and Py Rig (mudrii/hermesd, 119 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Refactoring?

ciembor (a GitHub user) maintains it in ciembor/agent-rules-books, which has 2,927 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on September 10, 2026.

Source: ciembor/agent-rules-books on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.