Skill1.3k repo starsupdated today

spk-start-agent-surface

This skill routes Spec Kitty questions to the appropriate workflow by identifying which surface the user is working from (CLI, Codex, Claude Code, slash-command host, or command-skill host) and determining what capabilities are available in that environment. Use it when questions involve where commands appear, how behavior differs across surfaces, or why certain features aren't working in a specific context.

View source Repository: spec-kitty

Install in Claude Code

Copy

git clone --depth 1 https://github.com/Priivacy-ai/spec-kitty /tmp/spk-start-agent-surface && cp -r /tmp/spk-start-agent-surface/src/doctrine/skills/spk-start-agent-surface ~/.claude/skills/spk-start-agent-surface

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# 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 `.kitty/` or worktrees.