skills.rest
clay-good
clay-goodCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

spec-gen-plan-refactor

Plan high-priority refactors and save executable plans to .spec-gen/refactor-plan.md.

270|34|Updated Jan 31, 2026
Search Tags:#planning#architecture#codebase#refactor#static-analysis#plan-generation#test-guardrails
One-click install
npx skills add https://github.com/clay-good/spec-gen --skill spec-gen-plan-refactor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-gen-plan-refactor
Source: https://github.com/clay-good/spec-gen/tree/main/examples/mistral-vibe/skills/spec-gen-plan-refactor
Command: npx skills add https://github.com/clay-good/spec-gen --skill spec-gen-plan-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan safe, high-priority refactors without mutating source files.

Core Features & Use Cases

  • Static analysis to surface top refactor candidates.
  • Blast-radius assessment to inform scope and risk.
  • Generated plan at .spec-gen/refactor-plan.md with a clear, executable sequence and validation steps.

Quick Start

Ask the skill to plan a refactor for your project, then review the generated .spec-gen/refactor-plan.md.

Frequently Asked Questions about spec-gen-plan-refactor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is blast radius assessment in a codebase refactor plan?▼

Assessing blast radius in a refactor plan measures the potential scope and risk of code changes across the codebase. This analysis informs the executable sequence and validation steps to ensure safe refactoring.

How do I identify high-priority refactoring targets using static analysis?▼

You can identify high-priority refactoring targets by running static analysis on your codebase to surface top candidates. The analysis evaluates code structure to prioritize changes that yield the highest impact with manageable risk.

Do I need a specific environment setup to generate a refactor plan?▼

To generate a refactor plan, you need a codebase analyzed by the spec-gen MCP server. Once analyzed, you can request a plan to produce a detailed, executable change sequence with validation steps.

What's the best way to structure an executable sequence for code refactoring?▼

The best way to structure an executable refactor sequence is to follow a stepwise change plan with explicit validation steps. The generated plan at .spec-gen/refactor-plan.md provides this structured sequence to guide safe implementation.

Can I review a generated refactor plan before applying code changes?▼

Yes, you can review the generated refactor plan before applying any code changes. The plan is saved to .spec-gen/refactor-plan.md, allowing you to inspect the stepwise sequence and validation steps prior to execution.

Related Skills

Explore More Software Engineering Skills→
FlexNetOSFlexNetOS

refactor-safety

Identifies direct and transitive dependencies of a symbol to assess refactoring impact.

Official
Intermediate
GrimblazGrimblaz
3

tdd-workflow

Guide teams through the TDD RED-GREEN-REFACTOR cycle with quality gates.

Community
Advanced
ResgridResgrid
224

code-review-workflow

Generate severity-ranked code review feedback for .NET changes using Roslyn MCP analysis.

Official
Advanced
nathanvalenathanvale
2

index-graph-navigator

Query a codebase call graph for blast radius and dead code analysis.

Community
Intermediate