Back to Skills

specswarm-upgrade

verified

Systematic compatibility analysis, migration guidance, and breaking change detection for dependency/framework upgrades. Auto-executes when user clearly wants to upgrade, update, migrate, or modernize software dependencies, frameworks, packages, or technology stacks.

View on GitHub

Marketplace

specswarm-marketplace

MartyBonacci/specswarm

Plugin

specswarm

Repository

MartyBonacci/specswarm
35stars

plugins/specswarm/skills/specswarm-upgrade/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/MartyBonacci/specswarm/blob/main/plugins/specswarm/skills/specswarm-upgrade/SKILL.md -a claude-code --skill specswarm-upgrade

Installation paths:

Claude
.claude/skills/specswarm-upgrade/
Powered by add-skill CLI

Instructions

# SpecSwarm Upgrade Workflow

Provides natural language access to `/specswarm:upgrade` command.

## When to Invoke

Trigger this skill when the user mentions:
- Upgrading or updating dependencies/packages
- Migrating to new frameworks or versions
- Modernizing technology stacks
- Bumping version numbers

**Examples:**
- "Upgrade React to version 19"
- "Update all dependencies"
- "Migrate from Webpack to Vite"
- "Modernize the build system"
- "Bump Node to version 20"

## Instructions

**Confidence-Based Execution:**

1. **Detect** that user mentioned upgrading/updating software
2. **Extract** what to upgrade from their message
3. **Assess confidence and execute accordingly**:

   **High Confidence (95%+)** - Auto-execute immediately:
   - Clear upgrade requests: "Upgrade React to version 19", "Update all dependencies", "Migrate from Webpack to Vite"
   - Action: Immediately run `/specswarm:upgrade "upgrade description"`
   - Show brief notification: "🎯 Running /specswarm:upgrade... (press Ctrl+C within 3s to cancel)"

   **Medium Confidence (70-94%)** - Ask for confirmation:
   - Less specific: "Update the packages", "Modernize the stack"
   - Action: Use AskUserQuestion tool with two options:
     - Option 1 (label: "Run /specswarm:upgrade"): Use SpecSwarm's upgrade workflow with compatibility analysis
     - Option 2 (label: "Process normally"): Handle as regular Claude Code request

   **Low Confidence (<70%)** - Always ask:
   - Vague: "Make it better", "Use newer stuff"
   - Action: Use AskUserQuestion as above

4. **If user cancels (Ctrl+C) or selects Option 2**, process normally without SpecSwarm
5. **After command completes**, STOP - do not continue with ship/merge

## What the Upgrade Command Does

`/specswarm:upgrade` runs complete workflow:
- Analyzes breaking changes and compatibility
- Creates comprehensive upgrade plan
- Generates migration tasks
- Updates dependencies and code
- Runs tests to verify compatibility
- Documents upgrade process

Stops af

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
2335 chars