spk-start-agent-surface

name	spk-start-agent-surface
description	Choose the correct Spec Kitty workflow for Codex CLI, Claude Code, and supported slash-command or command-skill harnesses.

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.