skills.rest
Priivacy-ai
Priivacy-aiOFFICIAL
Explore all skills by this author →
GitHub

spk-admin-setup-doctor

Diagnose and repair Spec Kitty installation, commands, and agent configuration issues.

1.6k|156|Updated Oct 9, 2025
Search Tags:#CLI#Troubleshooting#Installation#doctor#Setup#Agent configuration#Spec Kitty
One-click install
npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-admin-setup-doctor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spk-admin-setup-doctor
Source: https://github.com/Priivacy-ai/spec-kitty/tree/main/src/charter/offering/skills/spk-admin-setup-doctor
Command: npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-admin-setup-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spec Kitty installations can end up with missing slash commands, absent skills, broken agent paths, or unmet runtime prerequisites, leaving developers unable to run the spec-driven workflow. This Skill guides the diagnosis and repair of those setup failures.

Core Features & Use Cases

  • Setup Verification: Runs the appropriate setup or doctor command to check that commands, skills, and runtime files exist for the active agent surface.
  • Guided Repair: Prioritizes regenerating command skills through the proper tooling before manually editing installed copies.
  • Failure Diagnosis: Uses setup references and the legacy spec-kitty-setup-doctor alias for detailed diagnostics and path matrices.
  • Use Case: After installing Spec Kitty, your Claude Code slash commands do not appear. Use this Skill to run the doctor checks, verify agent config paths, and restore the missing generated commands.

Quick Start

Run the Spec Kitty setup doctor to verify my installation and repair any missing commands or agent configuration.

Frequently Asked Questions about spk-admin-setup-doctor

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

FAQPage Schema
How do I fix missing Spec Kitty slash commands?▼

Run the setup or doctor command appropriate to your install, then verify the slash commands and skills exist for your active agent surface. Regenerate command skills through the tooling before editing installed copies by hand.

How do I verify a Spec Kitty installation is working?▼

Use the setup doctor flow: run the doctor command, confirm commands, skills, and runtime files exist, and check agent config paths. The legacy spec-kitty-setup-doctor alias provides detailed diagnostics and path matrices.

Which AI coding agents does Spec Kitty setup support?▼

Spec Kitty supports agent surfaces including Claude Code, Codex, Cursor, Gemini, GitHub Copilot, Windsurf, and OpenCode. The doctor flow verifies that commands and skills exist for whichever agent surface is active.

Why are my Spec Kitty agent config paths broken after install?▼

Broken agent paths usually come from incomplete setup or missing runtime prerequisites. Run the doctor command to identify the failure, then consult the setup references for path matrices before manually editing installed files.

Should I edit installed Spec Kitty command files directly?▼

No. The recommended flow is to repair generated command skills using the setup tooling first, since manual edits to installed copies can be overwritten. Only edit by hand after regeneration fails.

Related Skills

Explore More Software Engineering Skills→
goondocks-cogoondocks-co
12

myco:install-and-initialize-myco

Automate Myco CLI installation, initialization, health checks, and maintenance.

Official
Advanced
kimprobablykimprobably

spec-kitty.tasks

Generate work-package breakdowns and tasks.md files from mission spec and plan artifacts.

Community
Advanced
Renzo-TognellaRenzo-Tognella

migrate-to-skills

Convert Cursor rules and slash commands to SKILL.md format.

Community
Basic
kimprobablykimprobably

spec-kitty-setup-doctor

Diagnose and recover broken Spec Kitty installations using verification commands.

Community
Advanced