# Spk Start Agent Surface

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

- Skill: `spec-kitty/spk-start-agent-surface` (Agent Skill)
- Install (CLI): `npx skillmds@latest add spec-kitty/spk-start-agent-surface`
- Raw SKILL.md: https://api.skillmd.com/api/skills/spec-kitty/spk-start-agent-surface/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: spec-kitty (https://skillmd.com/u/spec-kitty)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/spec-kitty/spk-start-agent-surface

---


# 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.