refactor SKILL.md skillA

refactor from yelmuratoff/agent_sync is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add yelmuratoff/agent_sync/refactor@git:20260728.7c60c81

Pins git:20260728.7c60c81 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
yelmuratoff/agent_sync
Path
.ai/src/skills/refactor/SKILL.md
Versions recorded
5
Latest version
git:20260728.7c60c81, committed Jul 28, 2026
First version recorded
Apr 5, 2026
Size
1,875 bytes
Repository stars
17
License
GPL-3.0

Restructure existing code without changing its behavior — reduce duplication, improve naming, simplify complex logic, extract helpers, split overgrown functions, untangle dependencies. Use this skill when the user asks to refactor, clean up, simplify, DRY out, rename, extract a helper, split a file, or make code "nicer" — including when they describe code-quality concerns without using the word "refactor" (e.g. "this is messy", "clean it up", "this could be done cleaner").

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

# Refactor

Safely restructure code while preserving existing behavior.

## Steps

1. **Verify tests exist** — Before touching anything, confirm test coverage on the code you'll change. If tests are missing, write them first against current behavior.
2. **Name the problem** — What exactly is wrong?
   - Duplicated logic? Function doing too many things? Poor naming? Tangled dependencies? Wrong abstraction?
3. **Plan the change** — Describe what you'll do before doing it. Small, safe steps.
4. **One change at a time** — Each step keeps the code working. Big rewrites collapse on themselves; small steps stay reversible.
5. **Run tests after each step** — If tests fail, you changed behavior. Undo and try smaller.
6. **Stop when good enough** — Clear, tested, easy to change = done.

## Gotchas

- Extract abstractions only when there is real duplication — three similar lines beat a premature helper.
- Reach for a design pattern when the problem calls for one, not to demonstrate knowledge.
- Confirm with the user before renaming across the entire codebase — the blast radius is bigger than it looks.
- Map the downstream callers before touching a public API.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add yelmuratoff/agent_sync/refactor@sha256:1524faa347a33520

The line at the top of this page pins the label git:20260728.7c60c81, 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_ozxzxwbl7gyo72g7.svg)](https://markdownregistry.com/a/art_ozxzxwbl7gyo72g7)

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

Versions

The registry has recorded 5 versions of this file, between Apr 5, 2026 and Jul 28, 2026, about one every 29 days.

versioncommittedcommitsizeaudit
git:20260728.7c60c81 latest2026-07-28 7c60c81 1,875 BA view · diff
git:20260512.5fd702f2026-05-12 5fd702f 1,911 BA view · diff
git:20260425.aadd1612026-04-25 aadd161 1,813 BA view · diff
git:20260405.10ecc092026-04-05 10ecc09 1,868 BA view · diff
git:20260405.fa7c92c2026-04-05 fa7c92c 1,468 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 (1875 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

yelmuratoff/agent_sync · 17 stars · license GPL-3.0 · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ozxzxwbl7gyo72g7
GET https://markdownregistry.com/api/v1/resolve?ref=yelmuratoff/agent_sync/refactor
GET https://markdownregistry.com/api/v1/blob/1524faa347a33520d255655e075b5f40c43d25355a773a23644a8708148be8ea

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 yelmuratoff/agent_sync

AGENTS.md@.ai/src AGENTS.md file
yelmuratoff/agent_sync · .ai/src/AGENTS.md
git:20261007.95b1395 · audit B · 17 stars
add-tool SKILL.md skill
yelmuratoff/agent_sync · .ai/src/skills/add-tool/SKILL.md · Add support for a new AI coding tool to Exuno's sync engine — create the tool YAML, configure targets and converters…
git:20261007.95b1395 · audit A · 17 stars
comments SKILL.md skill
yelmuratoff/agent_sync · .ai/src/skills/comments/SKILL.md · Scan recently written or edited code and remove comments that do not earn their place — narration, step markers…
git:20260512.5fd702f · audit A · 17 stars
commit SKILL.md skill
yelmuratoff/agent_sync · .ai/src/skills/commit/SKILL.md · Create a well-structured git commit for staged or unstaged changes — analyze the diff, match the project's existing…
git:20260728.7c60c81 · audit A · 17 stars
debug SKILL.md skill
yelmuratoff/agent_sync · .ai/src/skills/debug/SKILL.md · Investigate and fix bugs, errors, or unexpected behavior systematically — reproduce, locate, understand the root cause…
git:20260728.7c60c81 · audit A · 17 stars
fix-issue SKILL.md skill
yelmuratoff/agent_sync · .ai/src/skills/fix-issue/SKILL.md · Investigate and fix a GitHub issue in this repo — pull the issue with `gh`, trace it to the root cause across `src/`…
git:20260919.72b55dc · audit A · 17 stars
prompt-engineering SKILL.md skill
yelmuratoff/agent_sync · .ai/src/skills/prompt-engineering/SKILL.md · Design, debug, and refine prompts for LLM-based coding tools, agents, and pipelines. Use this skill when writing or…
git:20261007.95b1395 · audit A · 17 stars
release SKILL.md skill
yelmuratoff/agent_sync · .ai/src/skills/release/SKILL.md · Bump the Exuno version, write a CHANGELOG entry summarising changes since the last tag, and prepare a clean release…
git:20261012.dc99d8c · audit A · 17 stars
review SKILL.md skill
yelmuratoff/agent_sync · .ai/src/skills/review/SKILL.md · Perform a structured code review on a diff, PR, or staged changes — surface correctness, security, error-handling…
git:20261007.95b1395 · audit A · 17 stars
AGENTS.md@example/.ai/src AGENTS.md file
yelmuratoff/agent_sync · example/.ai/src/AGENTS.md
git:20260331.a1a2b85 · audit A · 17 stars
commit SKILL.md skill
yelmuratoff/agent_sync · example/.ai/src/skills/commit/SKILL.md · Create a well-structured git commit for staged or unstaged changes — analyze the diff, match the project's existing…
git:20260728.7c60c81 · audit A · 17 stars
debug SKILL.md skill
yelmuratoff/agent_sync · example/.ai/src/skills/debug/SKILL.md · Investigate and fix bugs, errors, or unexpected behavior systematically — reproduce, locate, understand the root cause…
git:20260728.7c60c81 · audit A · 17 stars

Every file in yelmuratoff/agent_sync

Other files named refactor

refactor SKILL.md skill
code-yeongyu/oh-my-openagent · packages/shared-skills/skills/refactor/SKILL.md · Guides a refactor, cleanup, or restructure with the right decomposition. Use when the user asks to refactor, simplify…
git:20260929.9a41ccb · audit A · 70,277 stars
refactor SKILL.md skill
codeaholicguy/ai-devkit · skills/refactor/SKILL.md · AI DevKit · Systematic structural or multi-file refactors across any stack while preserving behavior and public…
git:20260826.c1f5930 · audit A · 1,648 stars
refactor SKILL.md skill
sethgammon/citadel · skills/refactor/SKILL.md · Safe multi-file refactoring with automatic rollback. Establishes a type/test baseline, plans all changes, executes…
git:20260611.0f3f8e7 · audit A · 925 stars
refactor SKILL.md skill
dcouple/pane · main/src/services/paneChatBundle/skills/refactor/SKILL.md · Post-PR refactor pass. Sizes the diff against the remote default branch, fans out refactor-simple (and refactor-deep on…
git:20260924.c3bd4b5 · audit A · 577 stars
refactor SKILL.md skill
greenfield-inc/pane · main/src/services/paneChatBundle/skills/refactor/SKILL.md · Post-PR refactor pass. Sizes the diff against the remote default branch, fans out refactor-simple (and refactor-deep on…
git:20260924.c3bd4b5 · audit A · 575 stars
refactor SKILL.md skill
boshu2/agentops · skills/refactor/SKILL.md · Restructure or clean up code with no behavior change, proved by before-and-after checks. Use when: asked to clean up…
git:20261005.4fda294 · audit A · 450 stars
refactor SKILL.md skill
boshu2/agentops · plugin/skills/refactor/SKILL.md · Restructure or clean up code with no behavior change, proved by before-and-after checks. Use when: asked to clean up…
git:20261010.407c70b · audit A · 450 stars
refactor SKILL.md skill
testdouble/han · han-coding/skills/refactor/SKILL.md · Restructure existing code without changing its behavior, through a test-gated refactoring loop: a named target, a green…
git:20260915.ec2cb7c · audit A · 319 stars

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