refactor

A guide for making one consistent code change across many files, such as renaming a symbol or changing a function's inputs.

In plain words
What is it for?
It is for safe codebase-wide refactors followed by checks that confirm the old pattern has been handled everywhere intended.
Why use it?
It helps find every affected definition, use, import, comment, and test before editing, reducing missed references and accidental changes.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/1aifanatic/super-computer/refactor
Any agent
npx skills add 1aifanatic/super-computer --skill refactor
Clone the repo
git clone --depth 1 https://github.com/1aifanatic/super-computer

Made for: Claude Code, Codex.

Per session 39 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 459 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00039 $0.00459
Opus 5 $0.00019 $0.00230
Sonnet 5 $0.00008 $0.00092
Haiku 4.5 $0.00004 $0.00046

Measured 2d ago against content hash 29432c001131, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

refactor scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/refactor/SKILL.md · 36 lines

What it actually says

Systematic multi-file edits

The danger in a refactor is not the edit, it is the edit you did not know you needed to make. Find the full blast radius before changing anything.

Always, in this order

  1. Enumerate. grep -rn "oldName" /workspace — every occurrence, before touching one.
  2. Count. grep -rc "oldName" /workspace per file, so you know when you are done.
  3. Classify. Definitions, call sites, imports, strings, comments and tests need different treatment. A blind replace corrupts the ones that are not code.
  4. Edit with edit_file, one occurrence at a time with enough surrounding context to be unique.
  5. Verify. grep -rn "oldName" /workspace again. Zero results, or only the ones you deliberately left.

Use edit_file, not write_file

Rewriting a file to change one line bills the whole file as output tokens and risks losing anything you did not carry across. edit_file fails loudly when old_string is not unique, which is a feature: that error is telling you the change is ambiguous and needs more context.

When a change genuinely is uniform across a file, replace_all is correct — but check the count first so you know what you are agreeing to.

Partial-word traps

grep matches substrings. Renaming user will also hit username, userId and superuser. Anchor the pattern:

grep -rnw "user" /workspace
grep -rn "\buser\b" /workspace

The limit you must state

You cannot run the tests, the build, or the type checker. A refactor that looks complete is unverified. When you finish, say so plainly — "renamed 14 occurrences across 6 files; not compiled or tested" — rather than implying the change is known good.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 36 lines · 39 tokens per session scan A 29432c001131

Subscribe to this mod's changes

refactor is a skill published in the GitHub repository 1aifanatic/super-computer (2 stars, last pushed 21d ago), licensed MIT. It adds 39 tokens to every session and 459 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

changelog-writer

This skill should be used when the user asks to "add a changelog entry", "write changelog", "audit changelog", "review changelog", "check changelog entries", or is editing docs-mintlify/changelog.mdx. Enforces a consistent, reader-facing voice and cuts implementation trivia.

pdugan20/rewind · 68 tokens

add-media

This skill should be used when the user asks to "add a movie", "add a vinyl", "add to my collection", "add physical media", "add a Blu-ray", "add a CD", or "bought these records". It handles both movies (via TMDb/Trakt) and music (via Discogs).

pdugan20/rewind · 71 tokens

media-search

This skill should be used when the user asks to "search for a movie", "find a record on Discogs", "look up a film", "search TMDb", "search Discogs", "what's the TMDb ID for", "what's the Discogs ID for", or wants to look up media metadata before adding it to the collection.

pdugan20/rewind · 75 tokens

frontend-design-landing-page

Marketing landing page and conversion-focused product page reference. Use this skill when building hero sections, feature grids, pricing pages, testimonials, CTAs, footers, navigation bars, or any public-facing marketing surface. Covers a warm, professional, developer-friendly design language (cream backgrounds…

cloudflare/vibesdk · 106 tokens

frontend-design-saas

S-tier SaaS dashboard and product UI reference. Use this skill when building application shells, data tables, settings panels, billing pages, dashboards, auth flows, admin tools, or any internal/customer-facing SaaS product UI. Inspired by Stripe, Linear, Vercel, Airbnb, Notion. Covers neutral-led design tokens…

cloudflare/vibesdk · 105 tokens

cloudflare-bundler-apps

Author Cloudflare Worker Bundler-compatible apps that build and preview correctly inside a space. Use this skill whenever you scaffold, modify, or deploy a project that will be built with @cloudflare/worker-bundler (i.e. anything served from /space/:name/preview/:branch/). Covers wrangler config, project layout…

cloudflare/vibesdk · 105 tokens