Skip to content
Agent Orchestration
Skill

/spk-start-agent-surface

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

BOOST
@spec-kittyspec-kitty@spec-kitty
From plugin
spec-kitty
1.7k45 skills1 command

Claude Code

$ npx -y skills add spec-kitty/spec-kitty --skill spk-start-agent-surface --agent claude-code

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.

Read it on GitHub ↗
Stats
PythonBashLinuxGitGitHubAnthropicGemini
1,719
Stars
195
Forks
Active
Maintenance
Python
Language
MIT
License
Last commit
Created
Added

Repo: spec-kitty/spec-kitty

In this plugin
45 skills1 command
See everything inside
@spec-kitty
Ships withspec-kitty

Spec-Driven Development with organizational governance. Specs tell AI agents what to build; Charter governs how they build it. Git-native missions, enforceable workflows, and consistent engineering standards across AI coding agents and harnesses.

1.7k45 skills
Get the whole plugin

Stars on GitHub

Momentum

stars in total
1.7k
Star history of spec-kitty/spec-kitty on GitHub, a chart by star-history.com
See what's trending this week

Other skills on spec-kitty.

adversarial-squad

adversarial-squad

Deploy a bounded, profile-loaded adversarial review squad at a mission point-cut so independent doctrine lenses converge on…

spec-kitty
@spec-kitty@spec-kittyInstall Skill
See all 45 skills in spec-kitty

More skills from other plugins.

1password

1password

Set up and use 1Password CLI for sign-in, desktop integration, and reading or injecting secrets.

clawdis10d393k
@steipete@steipeteInstall Skill
computer-use

computer-use

Drives the GUI of a visible local app window through `orca computer`: accessibility tree, clicks, typing, menus, dialogs, and…

orca10d111k
@stablyai@stablyaiInstall Skill
agentmail

agentmail

Use your assigned AgentMail inbox to read email tasks, explicitly send or reply, and check delivery. Provided automatically by…

paperclip10d109k
@paperclipai@paperclipaiInstall Skill
adr-create

adr-create

Create a new Architecture Decision Record with sequential numbering and AgentDB registration

ruvnet-ruflo9d80k
@ruvnet@ruvnetInstall Skill

Questions about spk-start-agent-surface.

Which coding agents can use spk-start-agent-surface?
spk-start-agent-surface installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.