spec-kitty-setup-doctor

Solid

Install, verify, and recover the modern Spec Kitty 2.0.11+ operating surface. Triggers: "set up Spec Kitty", "skills missing", "next is blocked", "runtime is broken", "doctrine assets are missing", "my agent can't find the skills". Does NOT handle: generic coding questions with no Spec Kitty context, direct runtime loop advancement, or editorial glossary maintenance.

AI & Automation 1,281 stars 105 forks Updated today MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# spec-kitty-setup-doctor Diagnose and repair the Spec Kitty installation for the current project and agent. Use this skill when the user reports that Spec Kitty is not working, skills are missing, slash commands are unavailable, or the runtime environment appears broken. --- ## Step 1: Detect Environment Determine the active agent, repository state, and working directory. **What to check:** - Which AI agent is running (Claude Code, Codex, Gemini CLI, etc.) - Whether the current directory is inside a git repository - Whether a `.kittify/` directory exists (indicates prior initialization) - Whether this is a worktree or the repository root checkout **Commands:** ```bash git rev-parse --show-toplevel ls .kittify/config.yaml spec-kitty --version ``` **Expected outcome:** You know the agent identity, repo root path, and whether Spec Kitty was previously initialized. --- ## Step 2: Verify Installation Check that skill roots, wrapper roots, manifest, and generated artifacts are present. **What to check:** - Skill root directory exists for the active agent (see `references/agent-path-matrix.md`) - Wrapper root (slash-command directory) exists for the active agent - The relevant manifest exists and is valid JSON: `.kittify/skills-manifest.json` for legacy canonical skills and/or `.kittify/command-skills-manifest.json` for command-skill agents - Skill files listed in the manifest are present on disk **Commands:** ```bash spec-kitty verify-setup ``` If `spec-kitty...

Details

Author
Priivacy-ai
Repository
Priivacy-ai/spec-kitty
Created
7 months ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

spec-kitty.analyze

Cross-artifact consistency and quality analysis

1,281 Updated today
Priivacy-ai
AI & Automation Listed

speckit-install

Install the SpecKit CLI and initialize the current repository for one or both coding-agent integrations (Claude Code, Codex CLI). Use when the operator says: 'install speckit', 'set up speckit', 'initialize speckit in this repo', 'add speckit to this project', 'specify init for me', 'install spec-kit', '$speckit-install', or has a repo with no .specify/ directory and wants to start using Spec-Driven Development. Detects existing installs and hands off to $speckit-upgrade rather than overwriting. Safe to run on any repo. Not for upgrading an existing speckit install ($speckit-upgrade), not for scaffolding a new spec on an already-installed repo ($speckit-scaffold-spec), and not for installing this plugin's own bundled Codex subagents (use $install for that).

0 Updated yesterday
racecraft-lab
AI & Automation Solid

spec-kitty.research

Generate research documents for the current mission

1,281 Updated today
Priivacy-ai
AI & Automation Listed

setup-isolated-setup-doctor

Probe the secure-agent setup for in-session functional restrictions that block legitimate workflows. Three live probes — SSH agent / Yubikey reachability, localhost port binding, docker / podman runtime socket — each mapped to a numbered entry in `docs/setup/sandbox-troubleshooting.md` with the matching settings.json remediation. Read-only — never modifies settings.json, never invokes the sandbox bypass.

17 Updated today
apache
AI & Automation Listed

doctor

Run diagnostics on the sr plugin installation. Checks that all agents are available, required tools are installed, config files are valid, and memory directories exist. Outputs a health report with actionable fixes.

9 Updated today
fjpulidop