skills.rest
kimprobably
kimprobablyCOMMUNITY
Explore all skills by this author →
GitHub

spec-kitty-setup-doctor

Diagnose and recover broken Spec Kitty installations using verification commands.

Updated May 13, 2026
Search Tags:#slash commands#installation verification#spec kitty#runtime repair#skills missing#manifest drift#re-initialization
One-click install
npx skills add https://github.com/kimprobably/maestro-os --skill spec-kitty-setup-doctor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-kitty-setup-doctor
Source: https://github.com/kimprobably/maestro-os/tree/main/.claude/skills/spec-kitty-setup-doctor
Command: npx skills add https://github.com/kimprobably/maestro-os --skill spec-kitty-setup-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It diagnoses and repairs broken Spec Kitty installations so your agent can reliably locate skills, restore slash commands, and unbreak the runtime environment.

Core Features & Use Cases

  • Environment detection: Identifies the active agent, repository root, working directory, and whether Spec Kitty was initialized via a .kittify/ directory.
  • Installation verification: Checks skill roots, wrapper roots, manifests, and on-disk skill file presence using spec-kitty verify-setup, including remediation when spec-kitty is missing.
  • Deterministic recovery: Matches observed symptoms to known failure signatures (missing roots, manifest drift, missing runtime, dashboard issues) and applies consistent repair commands such as spec-kitty init --here or spec-kitty dashboard.

Quick Start

Ask the assistant to run the Spec Kitty setup doctor for your repo and recover from any detected “skills missing” or “runtime is broken” failures.

Frequently Asked Questions about spec-kitty-setup-doctor

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

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

Spec Kitty installation verification checks skill roots, wrapper roots, manifests, and on-disk skill file presence using `spec-kitty verify-setup`. It matches observed symptoms like missing roots or manifest drift to known failure signatures for targeted repair.

What causes manifest drift and missing skills in Spec Kitty?▼

Manifest drift and missing skills occur when Spec Kitty cannot locate its `.kittify/` configuration directory or when installed skill roots diverge from manifest records. Re-initialization using `spec-kitty init --here` resolves this by restoring deterministic configuration state.

Can I recover a Spec Kitty installation if the spec-kitty command is missing?▼

Yes, you can recover a Spec Kitty installation when the `spec-kitty` command is missing. The setup doctor includes remediation steps that detect the missing runtime and apply targeted re-initialization commands to restore the environment and unblock the agent.

Why does my agent report skills missing after Spec Kitty initialization?▼

Agents report skills missing after Spec Kitty initialization when the environment lacks valid `.kittify/` configuration, wrapper roots are invalid, or manifest drift occurred. Run `spec-kitty verify-setup` to validate on-disk skill presence and apply the indicated repair commands.

Do I need a .kittify directory to run Spec Kitty setup doctor?▼

A `.kittify/` directory is required for Spec Kitty initialization, but the setup doctor can diagnose its absence. If the directory is missing or corrupted, the doctor identifies the environment state and applies `spec-kitty init --here` to re-initialize the repository configuration.

Related Skills

Explore More Software Engineering Skills→
MINT-IAMINT-IA

gsd-health

Diagnose planning directory health and repair issues with a --repair argument.

Official
Intermediate
taomiaotaomiao
145

alfworld-search-verifier

Revisit previously visited receptacles to verify the presence or absence of target objects.

Community
Intermediate
zcheezchee
1

doctor

Diagnose Codex/OMX installation health by checking plugin caches and configuration files.

Community
Advanced
leeoveryleeovery
27

migrate

Apply pending migrations to sync workflow files with system design.

Community
Basic