speckit-ship-run

Transforms specification-backed work into a reviewable pull request with readiness checks and changelog generation.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-ship-run
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-ship-run
Source: https://github.com/B0yZ4kr14/OrthoPlus-Enterprise/tree/main/.specify-backups/20260518-141826/_agents/skills/speckit-ship-run
Command: npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-ship-run

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns completed specification-driven work into a shippable pull request by automating readiness checks, branch synchronization, changelog generation, CI verification, and PR creation.

Core Features & Use Cases

  • Pre-flight readiness gates: Verifies task completion, review status, QA status, and a clean working tree before proceeding.
  • Safe release engineering: Synchronizes the feature branch with the target branch (with explicit confirmations) and updates a structured changelog.
  • Traceable PR packaging: Generates a spec-linked PR description from .specify artifacts and archives release evidence for auditability.
  • Optional extension hooks: Runs configurable before_ship and after_ship extension hooks from .specify/extensions.yml when present.

Quick Start

Run the shipping workflow from the spec-kit project root by invoking the skill with no extra arguments: /speckit-ship-run.

Frequently Asked Questions about speckit-ship-run

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

FAQPage Schema
How do I automate pull request creation from spec-kit project artifacts?

You can automate pull request creation by running the shipping workflow to transform specification-backed work into a reviewable PR, linking execution outputs and generating a traceable release artifact.

What readiness checks are required before shipping a spec-kit release?

Readiness checks verify task completion, review status, QA status, and a clean working tree before proceeding with branch synchronization and PR creation.

How do I generate a changelog and synchronize branches for a spec-kit release?

The workflow synchronizes the feature branch with the target branch using explicit confirmations and automatically updates a structured changelog during the release pipeline.

Can I use custom scripts during the spec-kit shipping workflow?

Yes, you can configure and run custom scripts by defining before_ship and after_ship extension hooks within the .specify/extensions.yml file.

How does CI verification work when creating a pull request from specifications?

CI verification is enforced during the PR packaging step to ensure safe-by-default confirmations before transforming completed specification-driven work into a shippable pull request.