Spk Start Agent Surface

Choose the correct Spec Kitty workflow for Codex CLI, Claude Code, and supported slash-command or command-skill harnesses.

spec-kitty b5883bf 1.0 KB Updated

File contents

spk-start-agent-surface

Use this skill when the question is about where Spec Kitty works, how commands or skills appear in a specific agent, or why behavior differs by surface.

Checks

  1. Identify the surface: command line, Codex, Claude Code, slash-command host, or command-skill host.
  2. Check whether slash commands, skills, and local filesystem access are available in that surface.
  3. If commands are missing, route to spk-admin-setup-doctor.
  4. If the user needs compatibility research, use the legacy spec-kitty-agent-surface-research skill when installed.

Guidance

  • Prefer local CLI workflows when the surface can read/write the repo.
  • Prefer command skills for slash-command execution.
  • Prefer spk-* skills for explanation, recovery, and orchestration.
  • Do not assume cloud-hosted agents can access local .kittify/, kitty-specs/, or .worktrees/ paths.

spec-kitty/gapdb/tree/main/.agents/skills/spk-start-agent-surface commit b5883bfc4b

Frequently asked questions

npx skillmds@latest add spec-kitty/spk-start-agent-surface