Skip to content
Agent Orchestration
Skill

/spk-run-next

Drive the canonical spec-kitty next control loop and route query, step, blocked, decision_required, and terminal results.

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-run-next --agent claude-code

SKILL.md

spk-run-next.SKILL.md
name: spk-run-next
description: "Drive the canonical spec-kitty next control loop and route query, step, blocked, decision_required, and terminal results."

spk-run-next

Use this skill when advancing an active mission, asking what to do next, or recovering from a runtime decision.

Flow

1. Query state with `spec-kitty next --mission <handle> --json` or advance with `spec-kitty next --agent <name> --mission <handle> --result <success|failed|blocked>`. 2. Read the returned decision kind. 3. For `query`, inspect only; do not execute a prompt or mark a result. 4. For `step`, execute the generated prompt file. 5. For `decision_required`, answer with `--answer`, `--result`, `--agent`, and `--decision-id` when multiple decisions are pending. 6. For `blocked`, fix guard failures before retrying. 7. For `terminal`, route to `spk-gate-accept`.

Legacy Alias

For detailed runtime semantics, use `spec-kitty-runtime-next` when available.

Read it on GitHub ↗
Stats
PythonBashLinuxGitGitHubAnthropicGemini
1,724
Stars
197
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.

clawdis2w393k
@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…

orca2w111k
@stablyai@stablyaiInstall Skill
agentmail

agentmail

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

paperclip2w109k
@paperclipai@paperclipaiInstall Skill
adr-create

adr-create

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

ruvnet-ruflo2w80k
@ruvnet@ruvnetInstall Skill

Questions about spk-run-next.

Which coding agents can use spk-run-next?
spk-run-next 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.