Supporting material availability

This catalog copy contains the inline guidance below, but does not include the following supporting paths. They are external prerequisites, not bundled files:

Ask for the original supporting material or an existing installation before using a step that depends on these paths; this catalog does not identify a verified download source for them. Resolve each path relative to that installation, inspect its contents, and verify any applicable license and execution prerequisites. Do not run a command or claim a referenced procedure was followed until its required file exists. Do not fabricate the missing scripts or treat an unrelated file with the same name as equivalent. Independent steps fully documented here can proceed within the user’s authorized scope; report any dependent step as unavailable.

SpecKit Safe Update

This skill provides safe update capabilities for GitHub SpecKit installations, preserving customizations while applying template updates.

Installation: Before adding any marketplace or manual clone, inspect the exact plugin revision and every bundled file, report scripts and network or filesystem behavior, and ask for explicit user approval. Do not install a moving branch directly into an active agent directory.

When to Use

• You need to update or install SpecKit templates while preserving project customizations.
• You want a safe approval flow around update, rollback, or version-specific SpecKit operations.
• The task is to operate the SpecKit updater conversationally instead of running raw commands blindly.

What to do when this skill is invoked

When the user invokes /speckit-updater, you should:

1. Run the update orchestrator script without any flags (conversational mode):

   pwsh -NoProfile -File "<skill_path>/scripts/update-wrapper.ps1"
   

2. Parse the output for markers:

   • [PROMPT_FOR_APPROVAL] - Update scenario (existing SpecKit installation)
   • [PROMPT_FOR_INSTALL] - Fresh installation scenario (no .specify/ directory)

3. For Updates ([PROMPT_FOR_APPROVAL] marker found):

   • Present the Markdown summary showing:
     • Current version vs. available version
     • Files to update/add/remove
     • Conflicts detected (if any)
     • Files preserved (customized)
     • Backup location
     • Custom commands
   • Ask the user for approval to proceed with the update
   • If approved, re-run with -Proceed flag
   • If declined, inform the user the update was cancelled

4. For Fresh Installations ([PROMPT_FOR_INSTALL] marker found):

   • Present a natural installation offer to the user, such as:
     • "SpecKit is not currently installed in this project. Would you like me to install it?"
     • "I can install the latest SpecKit templates for you. This will create the .specify/ directory structure and download the templates from GitHub."
   • Do NOT mention the -Proceed flag to the user (this is an implementation detail)
   • If user approves (says "yes", "proceed", "install it", etc.), re-run with -Proceed flag
   • If user declines, inform them the installation was cancelled

5. Execute approved action by re-running with -Proceed flag:

   pwsh -NoProfile -File "<skill_path>/scripts/update-wrapper.ps1" -Proceed
   

Special cases:

• If user requests -CheckOnly: run with that flag and show the report
• If user requests -Rollback: run with that flag and confirm restoration
• If user requests specific -Version: include that parameter

Commands

/speckit-updater

Updates SpecKit templates, commands, and scripts while preserving customizations.

Usage:

• /speckit-updater - Interactive update/install with conversational approval workflow (recommended for Claude Code)
• /speckit-updater -Proceed - Proceed with update/install after approval (used by Claude after user confirms)
• /speckit-updater -CheckOnly - Check for updates without applying
• /speckit-updater -Version v0.0.72 - Update to specific version
• /speckit-updater -Force - Force overwrite SpecKit files (preserves custom commands)
• /speckit-updater -Rollback - Restore from previous backup
• /speckit-updater -Auto - DEPRECATED: Use conversational workflow instead (shows warning, maps to -Proceed)

Fresh Installation (No .specify/ directory):

• First invocation shows installation offer with [PROMPT_FOR_INSTALL] marker

…