spk-admin-upgrade

Upgrades Spec Kitty installations and repairs stale generated commands, skills, and migrations.

1.6k|156|Updated Oct 9, 2025

Search Tags:#compatibility #CLI #maintenance #upgrade #doctor #spec-kitty #Migration

Ready to run

npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-admin-upgrade

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: spk-admin-upgrade
Source: https://github.com/Priivacy-ai/spec-kitty/tree/main/src/charter/offering/skills/spk-admin-upgrade
Command: npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-admin-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After upgrading Spec Kitty to a new version, generated commands, skills, and compatibility shims can become stale or broken. This Skill guides the upgrade process and repairs generated assets so the project stays consistent with the installed CLI version.

Core Features & Use Cases

Version Detection: Identifies the installed Spec Kitty version versus the project version before making changes.
Guided Upgrade Flow: Runs the supported upgrade command and interprets migration output as a repair report for commands and skills.
Post-Upgrade Verification: Re-runs setup and doctor checks via spk-admin-setup-doctor to confirm the installation is healthy.
Use Case: After bumping spec-kitty-cli to a new release, run this Skill to migrate the project, repair stale generated skills, and verify the environment without manually editing installed files.

Quick Start

Upgrade my Spec Kitty installation to the latest version and repair any stale generated commands and skills.

Frequently Asked Questions about spk-admin-upgrade

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

FAQPage Schema

How do I upgrade Spec Kitty to a new version?▼

Identify the installed version and the project version, then run the supported upgrade command. Review the migration output for command and skill repairs, and finish by re-running setup and doctor checks to confirm the installation is healthy.

How do I fix stale generated commands and skills after a Spec Kitty upgrade?▼

Treat the upgrade output as a migration report listing what needs repair. Do not edit generated installed skills directly; instead update the source skills or command templates so the fixes persist across future upgrades.

Should I edit installed Spec Kitty skills directly to fix upgrade issues?▼

No. Generated installed skills should never be edited directly because changes are lost on regeneration. Fix the underlying source skills or command templates only when the migration reveals a real product defect.

How do I verify a Spec Kitty upgrade worked correctly?▼

Re-run the setup and doctor checks using the spk-admin-setup-doctor skill after upgrading. These checks validate that generated commands, skills, migrations, and compatibility shims match the installed version.

When should I not run the Spec Kitty upgrade flow?▼

Skip the upgrade flow when the installed and project versions already match, since there is nothing to migrate. Also avoid running it as a substitute for fixing genuine product defects, which belong in source templates.