Skip to main content
ClaudeWave
Skill1.3k repo starsupdated today

spk-start-here

The spk-start-here skill orients Spec Kitty users by their working environment (command line or agent harness) and routes them to the appropriate skill or command based on their immediate need, such as setup troubleshooting, starting a new feature, viewing available commands, or advancing existing missions. Use this skill when users need guidance on which Spec Kitty workflow to follow next.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/Priivacy-ai/spec-kitty /tmp/spk-start-here && cp -r /tmp/spk-start-here/src/doctrine/skills/spk-start-here ~/.claude/skills/spk-start-here
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# spk-start-here

Orient the user by where they are working: command line or supported agent
harness.

## Access Model

- Command-line users run `spec-kitty` CLI commands. `spk-*` skills are not CLI
  commands.
- Agent-harness users invoke installed command surfaces:
  `/spec-kitty.*` in slash-command hosts, `$spec-kitty.<command>` in Codex, or
  the host's skill syntax for skill hosts.
- Public `spk-*` skills are agent operating guides. Use them by name in a
  skill-aware harness or let natural-language intent trigger them.
- If commands or skills are missing, route to `spk-admin-setup-doctor`.

## Operating Model

Spec Kitty has three visible layers:

1. Commands: `/spec-kitty.*` slash commands and CLI commands that create or
   advance mission artifacts.
2. Skills: `spk-*` operating guides that teach an agent how to use the product.
3. Doctrine: charter, glossary, profiles, directives, and tactics loaded on
   demand by the runtime or by specialist skills.

Do not turn this into a full tutorial. Identify entry mode first, then route to
the smallest useful workflow.

## First Route

- New project or broken install: use `spk-admin-setup-doctor`.
- New feature from scratch: use `spk-start-first-feature`.
- User wants a command list: use `spk-start-command-map`.
- User asks "will this work in Codex or Claude?": use `spk-start-agent-surface`.
- Existing mission needs advancement: use `spk-run-next`.
- Multi-mission or multi-repo program: use `spk-run-program-orchestrate`.
- Review or approval work: use `spk-run-review-wp`, then `spk-gate-accept`.
- Team, SaaS, tracker, or sync concern: use `spk-team-sync` or `spk-team-tracker`.
- Doctrine or governance concern: use the `spk-doctrine-*` family.
- Unsure which skill applies: use `spk-meta-skill-map`.

## Agent Behavior

State the route, load only the routed skill, and continue. Prefer commands and
runtime outputs over guessing from files. If the user asks for a plan, give the
shortest workflow that gets them to the next concrete Spec Kitty action.