speckit-run-pipeline

Drives a feature through the full spec-kit phase sequence with artifact-based resume and gate handling.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-run-pipeline-narenkarthikbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-run-pipeline
Source: https://github.com/NarenKarthikBM/specseyal/tree/main/.claude/skills/speckit-run-pipeline
Command: npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-run-pipeline-narenkarthikbm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running a feature through a spec-driven development pipeline normally means issuing eleven or more phase commands by hand, tracking which phases already completed, and knowing when to stop for human gates. This Skill replaces that manual orchestration with a single command that reads the phase sequence from pipeline-config.yml, resumes from wherever the artifacts on disk indicate, and halts with a named cause and unblock path when something blocks. ## Core Features & Use Cases - Config-driven orchestration: Reads the phase sequence fresh from pipeline-config.yml on every run rather than hardcoding it, so the pipeline definition lives in exactly one place. - Stateless resume: Probes each phase's declared artifact for existence and validator conformance to find the resume point, with no state file, and discloses which completed phases only received the weaker structural check. - Closed-set halts and gates: Stops on exactly four conditions (phase_error, gate_human, residual_blocking, elevated_grant), each reporting its cause and unblock path verbatim from config, and never signs a human gate itself. - Multi-repo fan-out: With --repos, authors the spec and plan once at an umbrella root, seeds each child repo with identical copies plus an inherited profile.yaml, then dispatches one concurrent subagent per child to run the child-scoped phases. - Use Case: Paste a feature description with /speckit-run-pipeline in a spec-kit-initialized repo and the full specify-through-testing pipeline runs, pausing at the council gate for human approval and resuming afterward without re-running completed phases. ## Quick Start Run /speckit-run-pipeline followed by a feature description inside a git repository that has spec-kit initialized, optionally adding --repos a,b for multi-repo mode or --number NNN to pin the feature number.

Frequently Asked Questions about speckit-run-pipeline

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

FAQPage Schema
How do I run a full spec-kit pipeline with one command?

Invoke /speckit-run-pipeline with a feature description inside a git repository that has a .specify/ directory. The skill reads the phase sequence from pipeline-config.yml and drives each phase command in order, stopping only at gates or on a classified halt.

How does pipeline resume work after an interruption?

Resume works by probing each phase's declared artifact on disk for existence and validator conformance, with no state file involved. Re-invoke the same command and completed phases are skipped; phases whose artifacts are missing or fail validation become the resume point.

Can I run a feature across multiple repositories at once?

Yes, pass --repos a,b from an umbrella directory that has .specify/ but is not itself a git repo. The spec and plan are authored once at the umbrella, seeded identically into each child, and one concurrent subagent per child runs the child-scoped phases.

What happens when a pipeline gate requires human approval?

The run halts with a gate_human classification naming the unsigned gate's artifact and the approval command to use, such as /speckit-council-approve or /speckit-workforce-approve. The driver never signs a gate itself; after a human approves, re-invoking the command resumes past the gate.

Why does the pipeline halt with residual_blocking or elevated_grant?

residual_blocking fires when the council decision record still has blocking IDs after a phase runs, and elevated_grant fires when an artifact's grant tripwire names any grant. Both fire regardless of gate mode, and each halt report names the cause and the unblock path verbatim from the config.