skills.rest
Priivacy-ai
Priivacy-aiOFFICIAL
Explore all skills by this author →
GitHub

spk-start-agent-surface

Selects the correct Spec Kitty workflow for Codex CLI, Claude Code, and slash-command hosts.

1.6k|156|Updated Oct 9, 2025
Search Tags:#slash commands#workflow routing#Codex CLI#spec-kitty#ai coding agents#Claude code#agent surface
One-click install
npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-start-agent-surface
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spk-start-agent-surface
Source: https://github.com/Priivacy-ai/spec-kitty/tree/main/src/charter/offering/skills/spk-start-agent-surface
Command: npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-start-agent-surface

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI coding agents behave differently across surfaces: some support slash commands, some support command skills, and cloud-hosted agents cannot access local repository paths. This Skill removes the guesswork of figuring out which Spec Kitty workflow applies to your specific agent environment.

Core Features & Use Cases

  • Surface Identification: Determines whether you are working in a command line, Codex, Claude Code, a slash-command host, or a command-skill host.
  • Capability Checks: Verifies whether slash commands, skills, and local filesystem access are available in the current surface.
  • Routing Guidance: Directs you to spk-admin-setup-doctor when commands are missing, or to the legacy spec-kitty-agent-surface-research skill for compatibility research.
  • Use Case: You installed Spec Kitty but slash commands do not appear in your agent. This Skill identifies your surface, checks capability availability, and routes you to the setup doctor for recovery.

Quick Start

Ask the agent which Spec Kitty workflow and commands are available in my current coding environment.

Frequently Asked Questions about spk-start-agent-surface

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I know which Spec Kitty workflow to use in my AI agent?▼

Identify your surface first: command line, Codex, Claude Code, slash-command host, or command-skill host. Then check whether slash commands, skills, and local filesystem access are available, and choose the workflow matching those capabilities.

Why are Spec Kitty slash commands missing in my agent?▼

Missing commands usually mean the surface does not support slash commands or the setup is incomplete. Route to the spk-admin-setup-doctor skill to diagnose and repair the installation for your agent.

Does Spec Kitty work with cloud-hosted AI coding agents?▼

Cloud-hosted agents often cannot access local .kittify/, kitty-specs/, or .worktrees/ paths, so local CLI workflows may not apply. Prefer local CLI workflows when the surface can read and write the repository.

What is the difference between slash commands and command skills in Spec Kitty?▼

Slash commands execute through slash-command hosts, while command skills handle explanation, recovery, and orchestration via spk-* skills. Prefer command skills for slash-command execution and spk-* skills for guidance tasks.

When should I use the legacy spec-kitty-agent-surface-research skill?▼

Use it when you need deeper compatibility research about a specific agent surface and it is installed. The spk-start-agent-surface skill handles routine surface identification and routing instead.

Related Skills

Explore More Software Engineering Skills→
kimprobablykimprobably

spec-kitty-setup-doctor

Diagnose and recover broken Spec Kitty installations using verification commands.

Community
Advanced
Lee-SiHyeonLee-SiHyeon
10

doctor

Diagnose oh-my-copilot installation issues and apply safe repairs.

Community
Intermediate
sytonesytone
2

client-compatibility

Detect CLI, VS Code, or other platform surfaces and route agent spawning accordingly.

Community
Advanced
yaklangyaklang
1.6k

api-sec

Route API security assessments to focused testing workflows based on observed indicators.

Official
Intermediate