Skip to content
Development
Skill

/spk-start-agent-surface

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

From plugin
spec-kitty
1.5k53 skills1 command
Install
$ npx -y skills add Priivacy-ai/spec-kitty --skill spk-start-agent-surface --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/spk-start-agent-surface

Context preview

The summary Claude sees to decide when to auto-load this skill.

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

SKILL.md

spk-start-agent-surface.SKILL.md
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.

Ships withspec-kitty

Spec-Driven Development for serious software developers. Spec Coding with with Claude, Cursor, Gemini, Codex. Kanban dashboard, git worktrees, auto-merge and more.

Get the whole plugin

Other skills on spec-kitty.