refactoring-patterns SKILL.md skillA

This file is byte-identical to the first copy the registry indexed, one of 3 indexed copies. Same content hash, so the same checks give both the same grade.

refactoring-patterns from wondelai/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add wondelai/skills/refactoring-patterns@v1.4.1

Pins v1.4.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
wondelai/skills
Path
plugins/code-craftsmanship/skills/refactoring-patterns/SKILL.md
Versions recorded
1
Latest version
v1.4.1, committed Aug 9, 2026
Size
16,007 bytes
Repository stars
2,546
License
MIT

Apply named refactoring transformations to improve code structure without changing behavior. Use when the user mentions "refactor this", "code smells", "extract method", "replace conditional", "technical debt", "move method", "inline variable", "decompose conditional", or "clean up this messy code". Also trigger when cleaning up legacy code, preparing code for new features by restructuring, or identifying which transformation fits a specific code smell. Covers smell-driven refactoring, safe…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Refactoring Patterns Framework

A disciplined approach to improving the internal structure of existing code without changing its observable behavior. Every refactoring follows the same loop: verify tests pass, apply one small structural change, verify tests still pass.

## Core Principle

**Refactoring is not rewriting. It is a sequence of small, behavior-preserving transformations, each backed by tests.** You never change what the code does — only how it is organized. Big-bang rewrites fail because they combine structural change with behavioral change, making it impossible to know which broke things.

**The foundation:** Bad code is a natural consequence of delivering under time pressure, not a character flaw. Code smells are objective signals of degraded structure; the smell catalog tells you *where* to look, and the refactoring catalog tells you *what to do*.

## Scoring

**Goal: 10/10.** Score structural quality by how many of the eight [Quick Diagnostic](#quick-diagnostic) rows pass — `score = round(passed / 8 × 10)`, adjusting down when a single smell is severe. Bands:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add wondelai/skills/refactoring-patterns@sha256:e09d21bcca98b575

The line at the top of this page pins the label v1.4.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_s6enyz423hfxevgf.svg)](https://markdownregistry.com/a/art_s6enyz423hfxevgf)

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Aug 9, 2026.

versioncommittedcommitsizeaudit
v1.4.1 latest2026-08-09 ab2d28a 16,007 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (16007 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

wondelai/skills · 2,546 stars · license MIT · pushed 2026-09-10 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_s6enyz423hfxevgf
GET https://markdownregistry.com/api/v1/resolve?ref=wondelai/skills/refactoring-patterns
GET https://markdownregistry.com/api/v1/blob/e09d21bcca98b575df0014b3288df75afb556f2dd1d05135e6714d4c413d55d4

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from wondelai/skills

.cursorrules Cursor rule
wondelai/skills · .cursorrules
git:20260701.14a4958 · audit A · 2,546 stars
37signals-way SKILL.md skill
wondelai/skills · 37signals-way/SKILL.md · Build lean, opinionated products using the 37signals philosophy from "Getting Real", "Rework", and "Shape Up". Use when…
v1.3.1 · audit A · 2,546 stars
CLAUDE.md CLAUDE.md file
wondelai/skills · CLAUDE.md
git:20260829.6621b1f · audit A · 2,546 stars
architecture-optimization SKILL.md skill
wondelai/skills · architecture-optimization/SKILL.md · Guided journey from a working codebase grown slow and tangled to one measurably fast, cleanly bounded, and readable…
v1.0.0 · audit A · 2,546 stars
blue-ocean-strategy SKILL.md skill
wondelai/skills · blue-ocean-strategy/SKILL.md · Create uncontested market space using value innovation instead of competing head-to-head. Use when the user mentions…
v1.4.1 · audit A · 2,546 stars
clean-architecture SKILL.md skill
wondelai/skills · clean-architecture/SKILL.md · Structure software around the Dependency Rule: source code dependencies point inward from frameworks to use cases to…
v1.4.0 · audit A · 2,546 stars
clean-code SKILL.md skill
wondelai/skills · clean-code/SKILL.md · Write readable, maintainable code through disciplined naming, small functions, and clean error handling. Use when the…
v1.4.0 · audit A · 2,546 stars
cold-start-problem SKILL.md skill
wondelai/skills · cold-start-problem/SKILL.md · Start and scale networked products using Andrew Chen''s "The Cold Start Problem" framework for network effects. Use…
v1.2.0 · audit A · 2,546 stars
contagious SKILL.md skill
wondelai/skills · contagious/SKILL.md · Engineer word-of-mouth and virality using the STEPPS framework (Social Currency, Triggers, Emotion, Public, Practical…
v1.4.0 · audit A · 2,546 stars
continuous-discovery SKILL.md skill
wondelai/skills · continuous-discovery/SKILL.md · Build a weekly cadence of customer touchpoints using Opportunity Solution Trees, assumption mapping, and interview…
v1.4.0 · audit A · 2,546 stars
conversion-optimization SKILL.md skill
wondelai/skills · conversion-optimization/SKILL.md · Guided journey from a leaking conversion flow - landing page, signup, checkout, or in-app onboarding - to a measured…
v1.0.0 · audit A · 2,546 stars
create-app SKILL.md skill
wondelai/skills · create-app/SKILL.md · Guided journey from a raw app idea to a validated, cleanly architected first version that ships on a sustainable…
v1.0.1 · audit A · 2,546 stars

Every file in wondelai/skills

Other files named refactoring-patterns

refactoring-patterns SKILL.md skill
wondelai/skills · plugins/wondelai-skills/skills/refactoring-patterns/SKILL.md · Apply named refactoring transformations to improve code structure without changing behavior. Use when the user mentions…
v1.4.1 · audit A · 2,546 stars
refactoring-patterns SKILL.md skill
wondelai/skills · refactoring-patterns/SKILL.md · Apply named refactoring transformations to improve code structure without changing behavior. Use when the user mentions…
v1.4.1 · audit A · 2,546 stars
refactoring-patterns SKILL.md skill
akaszubski/autonomous-dev · plugins/autonomous-dev/skills/refactoring-patterns/SKILL.md · Safe refactoring techniques — extract, inline, rename, move, simplify conditionals, and decompose functions. Use when…
git:20260317.e64d556 · audit A · 34 stars
refactoring-patterns SKILL.md skill
benkapner/claude-code-basecamp · skills/refactoring-patterns/SKILL.md · Measurement-driven code refactoring — profile before changing, measure after, keep only if metrics improve. Covers…
v1.0 · audit A · 18 stars
refactoring-patterns SKILL.md skill
fabioc-aloha/alex_skill_mall · plugins/code-quality/refactoring-patterns/skills/refactoring-patterns/SKILL.md · Safe transformations — same behavior, better structure.
git:20260728.80a7ab6 · audit A · 5 stars

Browse by kind, by grade A, or by owner.