WI

windsurf-refactoring-large

Provides AI-assisted planning and phased execution for large refactoring tasks involving hundreds of files.

Install

mkdir -p .claude/skills/windsurf-refactoring-large && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/9435" && unzip -o skill.zip -d .claude/skills/windsurf-refactoring-large && rm skill.zip

Installs to .claude/skills/windsurf-refactoring-large

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Manage large-scale refactoring with Cascade coordination. Activate when users mention
"large refactoring", "codebase migration", "architecture refactor", "major refactoring",
or "system-wide changes". Handles complex refactoring operations. Use when working with windsurf refactoring large functionality. Trigger with phrases like "windsurf refactoring large", "windsurf large", "windsurf".
390 chars · catalog description✓ has a “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Advanced

Key capabilities

  • Plan large-scale refactoring
  • Execute phased refactoring
  • Validate system integrity
  • Perform rollback of failed phases

How it works

It breaks large refactoring into phased executions with checkpoints and automated validation.

Inputs & outputs

You give it
Refactoring scope and plan
You get back
Refactored codebase

When to use windsurf-refactoring-large

  • Migrating legacy architecture to a new framework
  • System-wide renaming of modules or patterns
  • Upgrading core dependencies across the entire codebase

About this skill

Windsurf Refactoring Large

Overview

This skill enables large-scale refactoring operations that span hundreds or thousands of files. It provides phased execution with checkpoints, comprehensive rollback capabilities, and AI-assisted planning.

Prerequisites

  • Windsurf IDE with Enterprise or Pro subscription
  • Active Cascade AI connection
  • Git repository with clean working state
  • Comprehensive test suite for validation
  • Backup strategy for critical code paths
  • Team coordination for multi-developer codebases

Instructions

  1. Analyze Scope
  2. Create Plan
  3. Prepare Environment
  4. Execute with Cascade
  5. Verify Completion

See ${CLAUDE_SKILL_DIR}/references/implementation.md for detailed implementation guide.

Output

  • Refactored codebase with all patterns migrated
  • Phase completion reports with metrics
  • Before/after performance comparison
  • Updated documentation and API references
  • Archived rollback artifacts (kept 30 days)

Error Handling

See ${CLAUDE_SKILL_DIR}/references/errors.md for comprehensive error handling.

Examples

See ${CLAUDE_SKILL_DIR}/references/examples.md for detailed examples.

Resources

When not to use it

  • When refactoring is small-scale
  • When no test suite exists

Prerequisites

Windsurf IDEGit repositorycomplete test suite

Limitations

  • Requires complete test suite
  • Depends on team coordination

How it compares

It provides a managed, phased approach for large-scale migrations instead of monolithic refactoring.

Compared to similar skills

windsurf-refactoring-large side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
windsurf-refactoring-large (this skill)02moReviewAdvanced
framework-migration-code-migrate14moNo flagsAdvanced
software-architecture3336moNo flagsIntermediate
solid-principles579moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

More by jeremylongshore

View all by jeremylongshore

analyzing-logs

jeremylongshore

Analyze application logs to detect performance issues, identify error patterns, and improve stability by extracting key insights.

14123

ollama-setup

jeremylongshore

Configure auto-configure Ollama when user needs local LLM deployment, free AI alternatives, or wants to eliminate hosted API costs. Trigger phrases: "install ollama", "local AI", "free LLM", "self-hosted AI", "replace OpenAI", "no API costs". Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.

1167

backtesting-trading-strategies

jeremylongshore

Backtest crypto and traditional trading strategies against historical data. Calculates performance metrics (Sharpe, Sortino, max drawdown), generates equity curves, and optimizes strategy parameters. Use when user wants to test a trading strategy, validate signals, or compare approaches. Trigger with phrases like "backtest strategy", "test trading strategy", "historical performance", "simulate trades", "optimize parameters", or "validate signals".

1071

generating-database-seed-data

jeremylongshore

Process this skill enables AI assistant to generate realistic test data and database seed scripts for development and testing environments. it uses faker libraries to create realistic data, maintains relational integrity, and allows configurable data volumes. u... Use when working with databases or data models. Trigger with phrases like 'database', 'query', or 'schema'.

1033

cursor-codebase-indexing

jeremylongshore

Execute set up and optimize Cursor codebase indexing. Triggers on "cursor index setup", "codebase indexing", "index codebase", "cursor semantic search". Use when working with cursor codebase indexing functionality. Trigger with phrases like "cursor codebase indexing", "cursor indexing", "cursor".

885

testing-mobile-apps

jeremylongshore

Execute mobile app testing on iOS and Android devices/simulators. Use when performing specialized testing. Trigger with phrases like "test mobile app", "run iOS tests", or "validate Android functionality".

810

Search skills

Search the agent skills registry