adaptive-refactor

adaptive-refactor is a skill for Claude Code, Codex from stackoverworld/primer-ai. It costs 0 tokens per session (354 once invoked), scanned A, original, MIT.

A workflow for reorganising existing code while keeping its behaviour unchanged, with smaller changes and checks after each step.

In plain words
What is it for?
Use it for behaviour-preserving refactors in Rust, Node.js, TypeScript, Vite, React, Next.js, or Swift projects, with the listed stack-specific checks.
Why use it?
It reduces the risk that a refactor introduces new behaviour or breaks existing behaviour by establishing a baseline and verifying each change.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it for behaviour-preserving refactors in Rust, Node.js, TypeScript, Vite, React, Next.js, or Swift projects, with the listed stack-specific checks.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/stackoverworld/primer-ai/adaptive-refactor
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.

Any agent
npx skills add stackoverworld/primer-ai --skill adaptive-refactor
Clone the repo
git clone --depth 1 https://github.com/stackoverworld/primer-ai

Made for: Claude Code, Codex.

Wrote 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.

agentmods badge for adaptive-refactor

README.md
[![agentmods](https://agentmods.dev/badge/skills/stackoverworld/primer-ai/adaptive-refactor/github.svg)](https://agentmods.dev/skills/stackoverworld/primer-ai/adaptive-refactor)
Your own site
<a href="https://agentmods.dev/skills/stackoverworld/primer-ai/adaptive-refactor"><img src="https://agentmods.dev/badge/skills/stackoverworld/primer-ai/adaptive-refactor/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.

agentmods 80×15 button for adaptive-refactor

Your own site · 80×15
<a href="https://agentmods.dev/skills/stackoverworld/primer-ai/adaptive-refactor"><img src="https://agentmods.dev/badge/skills/stackoverworld/primer-ai/adaptive-refactor.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 354 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00000 $0.00354
Opus 5.5 $0.00000 $0.00142
Sonnet 5.5 $0.00000 $0.00071
Haiku 4.5 $0.00000 $0.00035

Measured 2mo ago against content hash e8abca8f867a, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

adaptive-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 2mo 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/adaptive-refactor/SKILL.md · 32 lines

What it actually says

Adaptive Refactor Skill

Trigger

Use this skill when a request asks to refactor code while preserving behavior, especially across stack-specific toolchains.

Do Not Trigger

  • Net-new feature delivery where behavior-preservation is not the goal.
  • Cosmetic-only edits (typos, formatting-only passes, copy changes).
  • Pure explanation requests with no code edits.

Workflow

  1. Start with baseline safety loop:
    • establish current behavior and add/confirm invariants
    • create a narrow seam for the refactor
    • execute smallest safe change
    • verify before proceeding
  2. Apply baseline skill preference:
    • qa-refactoring as default safe workflow
  3. Add stack-specific skill(s) when relevant:
    • Rust: rust-refactor-helper
    • Next.js/React: vercel-react-best-practices
    • Node backend: nodejs-backend-patterns
    • Swift/iOS: ios-development
    • Large Vite reorganizations (optional specialist): react-vite-expert
  4. Prefer deterministic verification commands per stack:
    • Rust: cargo fmt, cargo clippy --fix, cargo test
    • TypeScript + Node backend: npx tsc --noEmit, npm run test, npm run build
    • Vite + TypeScript: npx tsc --noEmit, vitest run, vite build
    • Swift: swift format lint ., swift test
    • Next.js note: use project eslint scripts instead of next lint
  5. Keep output concise and contract-focused. If contracts change, update docs/ADRs in the same change.
Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 2mo ago First seen · 32 lines · 0 tokens per session scan A e8abca8f867a

Subscribe to this mod's changes

adaptive-refactor is a skill published in the GitHub repository stackoverworld/primer-ai (2 stars, last pushed 7mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 354 tokens. 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

adaptive-refactor compared with skills from other repositories

adaptive-refactor next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
adaptive-refactorstackoverworld/primer-aiSkill27mo agoMITA0Claude Code, Codex
imagegenopenai/codexSkill134ktodayApache-2.0A113Codex
local-ai-agentsmicrosoft/ai-agents-for-beginnersSkill79ktodayMITA200Claude Code, Codex
playwright-climicrosoft/playwrightSkill99ktodayApache-2.0A19Claude Code
systematic-debuggingobra/superpowersSkill314k3d agoMITA21Claude Code
next-cache-components-adoptionvercel/next.jsSkill143ktodayMITA95Claude Code
chat-pet-sprite-creationmicrosoft/vscodeSkill195ktodayMITA53Claude Code, Codex