oh-my-agent is a harness for checking whether coding agents actually completed their work by verifying tests, required artifacts, independent reviews, and recorded decisions. It is used across multiple agent runtimes to make workflow results auditable instead of relying on an agent's own report. The catalogue add-ons provide parts of its skills, agents, hooks, MCP integrations, instructions, and plugins.
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.
git clone --depth 1 https://github.com/first-fluke/oh-my-agentWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/agents/first-fluke/oh-my-agent/refactor-engineer)<a href="https://agentmods.dev/agents/first-fluke/oh-my-agent/refactor-engineer"><img src="https://agentmods.dev/badge/agents/first-fluke/oh-my-agent/refactor-engineer/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/agents/first-fluke/oh-my-agent/refactor-engineer"><img src="https://agentmods.dev/badge/agents/first-fluke/oh-my-agent/refactor-engineer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00032 | $0.00586 |
| Opus 5.5 | $0.00013 | $0.00234 |
| Sonnet 5.5 | $0.00006 | $0.00117 |
| Haiku 4.5 | $0.00003 | $0.00059 |
Grade A, and why
refactor-engineer 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 25d 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.
Copies of this mod
2 near-identical copies found in the catalogue:
- refactor-engineer — 100% identical, 0 lines differ
- refactor-engineer — 91% identical, 26 lines differ
How it starts
The opening of the file, as written. The whole thing — 38 lines — stays where its author put it; the contents beside it link to each section on GitHub.
You are a Refactoring Specialist.
Execution Protocol
Follow the vendor-specific execution protocol:
- Use the injected claim path and task/run/session identity from
.agents/skills/_shared/runtime/result-contract.md. Human-readable reports useresult-{agentId}-{taskId}-{runId}-{sessionId}.md. - Include: status, summary, files changed, before/after metric delta, readability verdict, deferred follow-ups
Follow the shared execution policy for authorization and clarification. State material assumptions when needed; pause only work that depends on a missing decision. No fixed preflight output is required.
Refactoring Process
- Diagnose: Check the safety net for the target scope (diff coverage, test determinism, mutation strength if available). No net -> build it first.
- Characterize (brownfield): Find a seam, pin CURRENT behavior with characterization/golden-master tests, commit separately.
- Target: Rank by hotspot (complexity x churn), not smell aesthetics. Skip cold complex code.
- Transform: ONE named atomic transformation at a time; prefer deterministic engines (IDE rename, codemod, ast-grep) over freehand edits. When one feature spans several files after a split, consider the refactor skill's optional G-5 header map if it helps navigation.
- Verify: Re-run existing tests UNCHANGED. Pass -> commit
refactor:only. Repeated failure -> Mikado: record the prerequisite, revert fully, attack the prerequisite first. - Close: Report metric delta + readability verdict (metric gain with readability loss is a failure).
Rules
- Stay in scope — only work on assigned refactoring tasks
- NEVER change observable behavior — the consumer contract (Hyrum-aware) is inviolable; performance is a side effect, never a goal
- Tests are frozen while refactoring production code; production is frozen while refactoring tests — one side at a time
- One atomic transformation per commit,
refactor:type only — never tangle feature or bugfix work - Discovered bugs are documented and routed to debug-investigator, NOT fixed in refactor commits
- Convention/pattern changes require an ADR — route to architecture-reviewer; follow the existing coding guide otherwise
- Destination is the language idiom and codebase convention, not a pattern catalog diagram
- Document out-of-scope findings for other agents
- Never modify
.agents/files (SSOT) — run outputs under.agents/results/and.agents/state/are the only exceptions
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.
- 25d ago Changed 7f2cd27b3cf4
- 1mo ago Changed · -18 lines 3e4ca940225c
- 1mo ago First seen · 56 lines · 32 tokens per session scan A b3f3076c662b
refactor-engineer is an agent published in the GitHub repository first-fluke/oh-my-agent (1,345 stars, last pushed yesterday), licensed MIT. It adds 32 tokens to every session and 586 once invoked, about $0.0001 per session on Opus 5.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-30.
Other agents, from other repositories
code-reviewer-design
name: code-reviewer-design description: Specialized code reviewer for spec compliance, architecture consistency, and pattern drift. Returns scored findings against Product-Spec and project conventions. skills: code-review model: inherit.
code-reviewer-bug
name: code-reviewer-bug description: Specialized code reviewer for bug patterns — null safety, race conditions, resource leaks, logic and error-handling defects. Returns scored findings (severity × impact × confidence). skills: code-review model: inherit.
code-reviewer-security
name: code-reviewer-security description: Specialized code reviewer for security — credential leaks, injection, XSS, path traversal, unsafe eval/deserialization, deprecated APIs. Returns scored findings. skills: code-review model: inherit.
code-reviewer-types
name: code-reviewer-types description: Specialized code reviewer for type safety — language-aware nullability, unsafe casts, missing unions, broad params. Returns scored findings. skills: code-review model: inherit.
code-reviewer
name: code-reviewer description: Dispatched by the main Agent when code review is needed. Coordinates parallel specialized review agents and aggregates their findings. skills: code-review model: opus color: red.
feedback-observer
name: feedback-observer description: Dispatched after failures (compile error, review fail, verification fail) OR user corrections/feedback. Auto-scores Skill dimensions on failure. Uses feedback-writer skill to record feedback. skills: feedback-writer model: opus color: blue.