Skip to main content
skill CX Codex

deliver-spec — Claude Code skill: what it does, how to install

deliver-spec takes an approved GitHub issue or local specification and delivers it through a validated pull request. Useful when delegating implementation with mandatory independent review.

Apache-2.0 359 installs ★ 1,164 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add chrisbanes/skills --skill deliver-spec -a claude-code
Open on GitHub

What deliver-spec does

This skill manages implementation from an approved contract, handling either local spec files or GitHub tickets. It relies on to-plan for step breakdown and triggers triage if a GitHub issue lacks the ready-for-agent label. The lead agent implements sequential and tightly coupled code directly inside an isolated checkout, avoiding unnecessary worker delegation.

Before pushing or opening a pull request, the workflow assigns a fresh, read-only reviewer agent without prior implementation memory. This reviewer issues a verdict of ship, fix-first, or rethink. Continuous integration runs, PR operations, and checks belong to shepherd. Without explicit merge authority assigned to the specific invocation, the skill will not merge the pull request. When verification gates stall for about 30 minutes, it yields back with the exact pending checks for later resumption.

What it helps with

  • deliver an approved spec through a verified pull request
  • run independent read-only agent review before opening PRs
  • execute ticket handoffs from a run-github-project controller
  • reconcile pending checks and gates after stalled CI runs

Example prompts for the agent

  • Deliver the approved spec from specs/search-filter.md into a draft PR
  • Implement GitHub issue #128 following the deliver-spec workflow
  • Take over the claimed ticket handed off by run-github-project

How to install deliver-spec

1Skills CLI (Vercel)

npx skills add chrisbanes/skills --skill deliver-spec -a claude-code

2Manually: put the files in place

~/.claude/skills/deliver-spec/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/deliver-spec/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about deliver-spec

How to install deliver-spec in Claude Code?

Run npx skills add chrisbanes/skills --skill deliver-spec -a claude-code. The skill definition installs to ~/.claude/skills/deliver-spec/SKILL.md.

What does the deliver-spec skill do?

It executes an approved specification into code, verifies changes against repository test suites, and requests review from an isolated agent. It then creates or updates a pull request while managing status gates.

Does deliver-spec merge pull requests automatically?

It merges strictly when explicit merge authority is granted for that execution. Otherwise, it leaves the PR open and reports the exact outstanding status gates.

Source text

SKILL.md · Apache-2.0
---
name: deliver-spec
description: Use when explicitly asked to deliver an approved GitHub or local spec through a reviewed pull request, or when a Project controller delegates one claimed implementation ticket.
compatibility: "Solo or delegated implementation uses the bundled procedure; triage is conditional. Never installs providers."
---

# Deliver spec

## Core principle

Deliver one approved outcome with proportional validation and independent final
review. The lead owns architecture, integration and delivery, and implements
tightly coupled or sequential work directly by default. Delegate only when
independent work, isolation or specialist investigation justifies the
overhead; available worker capacity alone does not. Preserve explicit ownership,
external-action permissions, execution budgets and invocation-specific merge
authority. Never select work from a Project queue.

## Select the mode

For an active `run-github-project` controller's verified ticket handoff, read
[Project controller handoff](references/project-handoff.md) and apply its
procedure instead of the standalone approval, merge, and timeout rules below.
The Project controller retains all shared state and merge authority.
For a direct named-spec request, use the standalone procedure below; if a
Project run already owns that issue, return it to that controller.

## Procedure

1. Resolve the named source, repository, approved contract, and any existing
   branch or PR from fresh state. On resume, reconcile the PR, exact head,
   checks, feedback, and authority before acting. For integration amendments,
   use [Evidence and review](references/evidence-and-review.md) to verify the
   installed planner contract and retained work before consuming any delta.
2. Plan: reuse a current `to-plan` plan; otherwise invoke `to-plan`
   (conversation mode for a local source) and honor its readiness and
   publication gates. A source qualifying for the [fast path](references/fast-path.md)
   applies it instead. For a GitHub issue missing `ready-for-agent`, first use
   `triage` and wait for its approved outcome; do not change labels yourself.
   Local sources skip triage but need explicit stakeholder approval. For an
   approved local source with no plan that does not qualify for the fast path,
   name conversation-mode `to-plan` as the initial route, including when
   answering a resume question.
   Approval covers the accepted contract and only the live qualification
   allowances it explicitly records; do not infer extra attempts or authority.
3. Verify scope and boundaries once. A verified handoff authorizes continuing
   in-scope implementation, testing and repairs in the isolated checkout;
   require no per-file or per-stage permission packets. Reuse valid plans,
   reviews and checks. Require earlier independent review only for a concrete
   risk that must be settled before proceeding, such as freezing experimental
   labels before observing outputs; build work independent of it, such as
   tooling, in parallel rather than after. Keep required deliverables and data-handling and spend limits;
   build no unrequested general infrastructure. Establish reviewer capability from runtime
   metadata, never by spawning a capability-only reviewer. If final review
   cannot run, report that delivery blocker without waiving review.
4. Follow the bundled [implementation procedure](references/implementation-mode.md)
   for solo or delegated work, ownership, isolation and recovery. Implement
   sequential or tightly coupled slices as the lead, not through a worker. Follow the stated repository or user testing policy.
   Reconcile retained work before implementing; never redo accepted work for
   routing.
   Follow [Evidence and review](references/evidence-and-review.md) for testing,
   corrections and the single reusable delivery record. When the source requires
   asynchronous or persistent live qualification, apply
   [Live qualification and failure recovery](references/qualification-failure.md)
   before attempts and resumes; do not add it to ordinary offline work.
5. Self-review the integrated candidate, run affected local and required
   pre-push checks, then give one independent read-only reviewer per delivery
   PR the approved source, repository standards, the exact clean candidate head
   and its validation evidence. Use a fresh agent that makes no
   writes and has no inherited implementation context. Reuse valid
   independent coverage; do not duplicate a plan or implementation review.
   Require evidence-backed findings and a `ship`, `fix-first`, or `rethink`
   verdict. Honor explicitly invoked provider contracts and report missing
   coverage. Return findings to the implementation owner; at the repaired head,
   renew affected checks and review changed ranges and interactions. Broaden only when impact cannot
   be bounded or an explicit requirement demands it. Confirm combined coverage
   of the final clean head before pushing. If finished, verified work leaves
   the final diff empty, report `no-change`; a starting empty diff is not
   `no-change`. Otherwise create one draft PR, or reuse the existing PR, and
   verify its head is the reviewed head. Apply
   [PR review timing](references/pr-review-timing.md): start applicable external review
   while CI runs, using verified draft support or earlier PR readiness when
   permitted. Keep delivery `pending` until all final-head gates pass. Use
   closing links only for verified GitHub issues.
6. `shepherd` owns CI, feedback and every PR operation. Keep repairs with their
   implementation owner; renew affected checks and focused review at the
   repaired head before pushing. Routine implementation or fixture corrections preserving
   requirements, coverage, architecture and authority proceed under the existing
   approval; record them briefly. Material changes require the appropriate
   decision and replan before affected work continues. Weakened qualification
   or expanded permissions are material. Merge only with explicit authority
   valid for this invocation. After about 30 minutes of pending gates, hand back
   the exact pending checks, feedback, PR and head for later resume.

## Finish gate

Report `ready` only when the final head passes required checks and reviews
with findings resolved and evidence applicable to that clean head;
`merged` only after authorized merge readback;
`no-change` only when implementation and verification finish with an empty
final diff; `pending` with exact outstanding gates; otherwise `blocked` with the
needed decision or capability. Preserve the PR and source pointers on pending
or blocked runs. Do not report a prior head as the reviewed result.

© chrisbanes · Apache-2.0 · chrisbanes/skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set21

The whole set →
to-plan to-plan turns one GitHub issue or an in-chat task into an implementation plan with acceptance criteria. Useful when the work has to be handed to someone else. CX Codex +1 884installs run-github-project run-github-project runs a repository's GitHub Project workflow: triages Todo, claims work in Ready to implement, and carries it through to Done. CX Codex +1 829installs implement-with-subagents implement-with-subagents orchestrates plan tasks across solo or worker subagents with task-scoped commits, integration checks, and mandatory independent review. CX Codex +1 807installs grounded-writing grounded-writing — a skill for drafting and reviewing developer docs, reports, and replies without invented facts, promotional filler, or irrelevant implementation mechanics. CX Codex +1 660installs android-benchmark-comparison android-benchmark-comparison enforces a reproducible procedure for comparing physical Android benchmark configurations. Helps resolve reversed rankings and pick measured defaults safely. CX Codex +1 559installs release-kotlin-library release-kotlin-library is a Claude Code skill that prepares, validates, and publishes Kotlin library releases. It checks changelogs and Metalava API snapshots before publication. CX Codex +1 559installs changelog A skill for Claude Code checks changelog entries against Git history and evidence from issues and PRs. It runs when preparing or reviewing release notes. CX Codex +1 159installs subagent-delegation The subagent-delegation skill for Claude Code manages subagent task distribution and reassignment. It runs when the user invokes the playbook or explicitly requests delegation. CX Codex +1 123installs

Project sponsors

Companies that keep this analytics open