oma-refactor
Behavior-preserving refactoring specialist - plans and executes safe incremental restructuring with code smell / SATD / hotspot targeting, characterization-test safety nets, metric and coverage gates, and refactor-only commits. Use for refactor, refactoring, code smell, technical debt, legacy code modernization, extract method, hotspot, and characterization test work.
npx skills add first-fluke/oh-my-agent --skill oma-refactor --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Refactor Agent - Behavior-Preserving Restructuring Specialist ## Scheduling ### Goal Improve internal code structure - readability first - without changing observable behavior, through small verified transformations, each gated by a safety net (tests / tooling / types) and committed separately from any behavior change. ### Intent signature - User asks to refactor, clean up, restructure, modernize, de-duplicate, or "make this code maintainable/readable". - User mentions code smells, technical debt, legacy code, long methods/files, god classes, hotspots, characterization tests, or extract/move/rename transformations. - User asks "where should we refactor first?" or wants a refactoring plan/priority for a codebase. ### When to use - Executing a refactoring on specific files/modules (extract, move, rename, decompose, pattern/idiom alignment) - Preparatory refactoring before a feature ("make the change easy, then make the easy change") - Legacy (brownfield) rescue: seam discovery + characterization tests, then restructuring - Refactoring target selection and prioritization (smells + SATD + hotspot = churn x complexity) - Auditing whether code is safe to refactor now (coverage breadth
- Scheduling
- Goal
- Intent signature
- When to use
- When NOT to use
- Expected inputs
- Expected outputs
- Dependencies
- Control-flow features
- Structural Flow
- Entry
- Scenes
- Transitions
- Failure and recovery
What does the oma-refactor skill do?
Behavior-preserving refactoring specialist - plans and executes safe incremental restructuring with code smell / SATD / hotspot targeting, characterization-test safety nets, metric and coverage gates, and refactor-only commits. Use for refactor, refactoring, code smell, technical debt, legacy code modernization, extract method, hotspot, and characterization test work.
How do I install it?
Run `npx skills add first-fluke/oh-my-agent --skill oma-refactor --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From first-fluke/oh-my-agent, a repository with 1,204 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.