refactor-plan SKILL.md skillA

refactor-plan from smart-ai-memory/attune-ai is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add smart-ai-memory/attune-ai/refactor-plan@git:20260628.4fd65a5

Pins git:20260628.4fd65a5 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
smart-ai-memory/attune-ai
Path
plugin/skills/refactor-plan/SKILL.md
Versions recorded
5
Latest version
git:20260628.4fd65a5, committed Jun 28, 2026
First version recorded
Apr 2, 2026
Size
2,506 bytes
Repository stars
11
License
Apache-2.0

Code-level refactoring analysis and roadmap. Detects duplication and complexity. Triggers on: refactor, tech debt, simplify, clean up, modularize, DRY, restructure.

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 Planning

**IMPORTANT: Start your response with a context preamble.**

Call `help_lookup(topic="refactor-plan", mode="preamble")` and
display the returned `preamble` text as a blockquote. Then
tell the user they can say "tell me more" for a step-by-step
guide, or answer the scoping questions below to proceed.

If the MCP call fails, fall back to:

> **Refactor Plan** — Analyzes code structure and produces a prioritized refactoring roadmap.

## Scoping

Before running, ask:

1. **Target**: "Which file or directory needs
   refactoring analysis?"
2. **Focus**: "Full analysis or specific concern?"
   - Full: `refactor_plan` (all areas)
   - Simplify: `simplify_code` (reduce complexity only)
3. **Depth**: "Quick scan or detailed roadmap?"

## Execution

Based on scope:

- Full analysis: `refactor_plan(path="<target>")`
- Simplify only: `simplify_code(path="<target>")`

Or via CLI:

```bash
attune workflow run refactor-plan --path <target>
```

## MCP Tools

| Tool | What It Does |
| ---- | ------------ |
| `refactor_plan` | Tech debt analysis and refactoring roadmap |
| `simplify_code` | Reduce complexity in specific files |

### refactor_plan
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add smart-ai-memory/attune-ai/refactor-plan@sha256:080a84b5df5dde88

The line at the top of this page pins the label git:20260628.4fd65a5, 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_xoojzy7nkgtb72zg.svg)](https://markdownregistry.com/a/art_xoojzy7nkgtb72zg)

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

Versions

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

versioncommittedcommitsizeaudit
git:20260628.4fd65a5 latest2026-06-28 4fd65a5 2,506 BA view · diff
git:20260625.50a33002026-06-25 50a3300 2,127 BA view · diff
git:20260406.799b6b72026-04-06 799b6b7 2,131 BA view · diff
git:20260403.3c8c1ff2026-04-03 3c8c1ff 1,848 BA view · diff
git:20260402.13df5d12026-04-02 13df5d1 1,876 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 (2506 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

smart-ai-memory/attune-ai · 11 stars · license Apache-2.0 · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xoojzy7nkgtb72zg
GET https://markdownregistry.com/api/v1/resolve?ref=smart-ai-memory/attune-ai/refactor-plan
GET https://markdownregistry.com/api/v1/blob/080a84b5df5dde88cd3c994ca2c2b68ec12e2cf241f2e81893f21aa9dac315f6

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 smart-ai-memory/attune-ai

AGENTS.md@.agents AGENTS.md file
smart-ai-memory/attune-ai · .agents/AGENTS.md
git:20260912.b63c07c · audit A · 11 stars
agent SKILL.md skill
smart-ai-memory/attune-ai · .agents/skills/agent/SKILL.md · Create and manage custom AI agents and teams
git:20260718.206f45d · audit A · 11 stars
attune-hub SKILL.md skill
smart-ai-memory/attune-ai · .agents/skills/attune-hub/SKILL.md · Developer workflow hub — routes to the right skill based on what you need. Triggers on: attune, what can attune do…
git:20260807.964ad7e · audit A · 11 stars
attune SKILL.md skill
smart-ai-memory/attune-ai · .agents/skills/attune/SKILL.md · AI-powered developer workflows with Socratic discovery
git:20260718.206f45d · audit A · 11 stars
author-feature SKILL.md skill
smart-ai-memory/attune-ai · .agents/skills/author-feature/SKILL.md · Author a single-source feature page — a code-verified master that projects to .help kinds + docs pages, no API credits…
git:20260727.d29a207 · audit A · 11 stars
brainstorm SKILL.md skill
smart-ai-memory/attune-ai · .agents/skills/brainstorm/SKILL.md · Guided brainstorming with structured discovery and plan output
git:20260718.206f45d · audit A · 11 stars
bug-predict SKILL.md skill
smart-ai-memory/attune-ai · .agents/skills/bug-predict/SKILL.md · Predict likely bug locations from code patterns and complexity. Triggers on: predict bugs, find bugs, risky code, code…
git:20260902.d668714 · audit A · 11 stars
bulk SKILL.md skill
smart-ai-memory/attune-ai · .agents/skills/bulk/SKILL.md · Batch API processing for 50% cost savings on non-urgent bulk analysis. Triggers on: batch, bulk process, batch API…
git:20260904.94c346c · audit A · 11 stars
catalog SKILL.md skill
smart-ai-memory/attune-ai · .agents/skills/catalog/SKILL.md · Enumerate everything attune offers — every workflow, wizard, and tool, read live from the registries. Triggers on…
git:20260626.c9b7431 · audit A · 11 stars
coach SKILL.md skill
smart-ai-memory/attune-ai · .agents/skills/coach/SKILL.md · Progressive help for any topic. Repeat to go deeper: concept -> procedural -> reference. Triggers on: coach, learn…
git:20260625.f0bf509 · audit A · 11 stars
code-quality SKILL.md skill
smart-ai-memory/attune-ai · .agents/skills/code-quality/SKILL.md · Code review to find quality issues, style violations, and code smells. Triggers on: review, code review, quality, lint…
git:20260628.4fd65a5 · audit A · 11 stars
commit-push-pr SKILL.md skill
smart-ai-memory/attune-ai · .agents/skills/commit-push-pr/SKILL.md · Stage, commit, push, and create PR in one command
git:20260718.206f45d · audit A · 11 stars

Every file in smart-ai-memory/attune-ai

Other files named refactor-plan

refactor-plan SKILL.md skill
archubbuck/workspace-architect · assets/plugins/context-engineering/skills/refactor-plan/SKILL.md · Plan a multi-file refactor with proper sequencing and rollback steps
git:20260423.f4df73b · audit A · 19 stars
refactor-plan SKILL.md skill
smart-ai-memory/attune-ai · .agents/skills/refactor-plan/SKILL.md · Code-level refactoring analysis and roadmap. Detects duplication and complexity. Triggers on: refactor, tech debt…
git:20260628.4fd65a5 · audit A · 11 stars
refactor-plan SKILL.md skill
aboudjem/ui-ux-suite · skills/refactor-plan/SKILL.md · Prioritized redesign action plan covering quick wins, medium effort, and major rework. Use when the user asks for a…
git:20260902.f0e063c · audit A · 7 stars
refactor-plan SKILL.md skill
gangjaeyu/harness_loop_full_korean · skills/refactor-plan/SKILL.md · 동작을 보존하는 코드 정리·의존성 갱신·스택 전환의 범위와 검증을 계획한다. 영향 문서와 필요한 작업만 보완하고 실행 요청이면 구현·검증까지 이어 수행한다.
git:20261029.9a25015 · audit A · 5 stars
refactor-plan SKILL.md skill
vivantel/kms · plugins/kms/skills/refactor-plan/SKILL.md · Produces a safe, phased refactoring plan that respects existing decisions and guardrails, without writing anything. Use…
git:20260830.b13e8e9 · audit A · 3 stars
refactor-plan SKILL.md skill
okhp3/skillz · community/refactor-plan/SKILL.md · Create a concrete plan before starting a multi-file refactor. Use when the user asks to plan, sequence, scope, or…
git:20260828.866dec6 · audit A · 3 stars

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