Skip to main content
skill CX Codex

utility-pm-release-conductor — Claude Code skill: 6-gate releases

Walks a pm-skills release through six gates: readiness, adversarial review, version bump, tag and post-tag hygiene. Refuses gate bypasses.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add product-on-purpose/pm-skills --skill utility-pm-release-conductor -a claude-code
Open on GitHub

What utility-pm-release-conductor does

The skill dispatches the pm-release-conductor sub-agent, which runs a release through six gates: G0 pre-tag readiness, G1 adversarial review, G2 version bump and CHANGELOG, G2.5 commit and re-verify, G3 tag and push, G4 post-tag hygiene. The flow pauses at every gate boundary for explicit maintainer confirmation. The tag goes only on the SHA captured at G2.5.

On Claude the skill invokes the native sub-agent @agent-pm-skills:pm-release-conductor, which chains to pm-skill-auditor at G0 and G2.5 and to pm-changelog-curator at G2. Other clients — Claude, Cursor, Copilot, Gemini CLI, OpenCode — have no native sub-agent, so the skill reads agents/pm-release-conductor.md and executes its instructions inline, pulling the auditor and curator in through a reference-and-execute-inline pattern.

That inline path is where things get tight. The auditor and curator share the conductor's context window, so a long release can push the combined token budget toward the limit. Inline execution also needs Bash, Read, Edit, Grep and Glob available — a read-only session will not carry the chain. A live release on Claude CLI has not been independently exercised, so the author advises running --dry-run first as a rehearsal.

If you only need an artifact review, a governance audit or a CHANGELOG draft, reach for the dedicated skills instead. This one is about the full release with confirmations.

What it helps with

  • run a pm-skills release through six gates with confirmation at each
  • get an adversarial review before bumping the version
  • draft the CHANGELOG and bump the version in one pass
  • tag only the SHA that passed re-verification
  • cut a release on Claude, Cursor or Gemini CLI without a native sub-agent

Example prompts for the agent

  • run the pm-skills 2.16.0 release through utility-pm-release-conductor
  • walk utility-pm-release-conductor in --dry-run mode as a rehearsal
  • conduct the release gate by gate and pause at G2 for confirmation

How to install utility-pm-release-conductor

1Skills CLI (Vercel)

npx skills add product-on-purpose/pm-skills --skill utility-pm-release-conductor -a claude-code

2Manually: put the files in place

~/.claude/skills/utility-pm-release-conductor/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/utility-pm-release-conductor/

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

Questions about utility-pm-release-conductor

How do I install utility-pm-release-conductor in Claude?

Run npx skills add product-on-purpose/pm-skills --skill utility-pm-release-conductor -a claude-code. The skill lands at ~/.claude/skills/utility-pm-release-conductor/SKILL.md.

What does utility-pm-release-conductor do?

It walks a pm-skills release through six gates: readiness, adversarial review, version bump and CHANGELOG, commit with re-verification, tag and push, post-tag hygiene. It does not allow gate bypasses.

Does the skill work outside Claude?

Yes. On Claude CLI, Cursor, Copilot, Gemini CLI and OpenCode it reads agents/pm-release-conductor.md and executes the steps inline. The auditor and curator then share the conductor's context window, and a live release on Claude CLI has not been independently exercised.

Source text

SKILL.md · Apache-2.0
---
name: utility-pm-release-conductor
description: Walk the guided 6-gate release runbook (G0 readiness, G1 adversarial review, G2 version bump and CHANGELOG, G2.5 commit and re-verify, G3 tag and push, G4 post-tag hygiene) via the pm-release-conductor sub-agent. Refuses gate bypasses and tags only the re-verified SHA. Use when cutting a pm-skills release.
license: Apache-2.0
metadata:
  classification: utility
  version: "1.0.1"
  updated: 2026-06-10
  category: release
  frameworks: [triple-diamond]
  author: product-on-purpose
---
<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->
# PM Release Conductor (Dispatch Skill)

Cross-client dispatch wrapper for the `pm-release-conductor` sub-agent. Detects runtime; dispatches to the native sub-agent on Claude Code; reads `agents/pm-release-conductor.md` and inlines chain composition on non-Claude clients via "reference + execute inline" pattern.

> **Status summary (v2.16.0):** PRODUCTION on Claude Code (native sub-agent path). DRY-RUN VALIDATED on Codex CLI 2026-05-17 per [`gate-test-results_2026-05-17_codex.md`](../../docs/internal/release-plans/v2.16.0/gate-test-results_2026-05-17_codex.md); LIVE release on Codex CLI is NOT independently exercised, so use with caution and run `--dry-run` first as a rehearsal. EXPERIMENTAL on Cursor / Windsurf / Copilot CLI / Gemini CLI (UNTESTED at v2.16.0 ship).
>
> See [Sub-Agent Compatibility Matrix](../../docs/reference/sub-agent-compatibility.md) for the canonical safe-usage matrix + what-was-validated detail + v2.17 expansion plan. For live release on a non-Claude client, ideally re-run the harness at [`maintainer-gate-testing-codex.md`](../../docs/internal/release-plans/v2.16.0/maintainer-gate-testing-codex.md) on that specific client first.

## When to Use

- You are running a pm-skills release on a non-Claude client (Codex CLI, Cursor, Windsurf, Copilot, Gemini CLI)
- You want the same 6-gate discipline that pm-release-conductor enforces on Claude Code, with auditor + curator behaviors inlined at the relevant gates
- You explicitly want skill-invocation semantics over sub-agent semantics on Claude Code (rare; the native sub-agent is preferred on Claude Code)

## When NOT to Use

- You only need to review a PM artifact -> use `utility-pm-critic`
- You only need a governance audit (not a release) -> use `utility-pm-skill-auditor`
- You only need a CHANGELOG draft (not a release) -> use `utility-pm-changelog-curator`
- You want to perform release operations WITHOUT explicit gate confirmation -> the conductor refuses bypass; manual release outside the conductor is the right path

## Instructions

**Runtime detection step.** Determine which AI client is invoking this skill.

### If you are running in Claude Code with the pm-skills plugin installed

Invoke `@agent-pm-skills:pm-release-conductor` with the user's target version + optional flags from `$ARGUMENTS`. The native sub-agent walks the 6 gates and natively chains to `pm-skill-auditor` (G0, G2.5) and `pm-changelog-curator` (G2) via the Agent tool. Return the conductor's gate-by-gate output to the user.

### If you are running in any other AI client

Codex CLI, Cursor, Windsurf, Copilot, Gemini CLI, or any other client without native pm-skills plugin sub-agent support:

1. Read the canonical sub-agent definition at `agents/pm-release-conductor.md`
2. Read the canonical runbook at `docs/contributing/release-runbook.md` (the conductor's referential source for gate definitions)
3. Execute the system prompt body as your operating instructions
4. Walk the 6 gates inline. At gates that require chain composition:
   - **G0 (Pre-tag readiness):** instead of chaining to pm-skill-auditor, read `agents/pm-skill-auditor.md` and execute the auditor's 4-step audit flow inline. Capture the layered output (full findings + Status Summary + Status YAML). Treat the Status YAML as your G0 sub-check 5 input.
   - **G2 (Version bump + CHANGELOG prep):** instead of chaining to pm-changelog-curator, read `agents/pm-changelog-curator.md` and execute the curator's 8-step drafting flow inline. Capture the layered output. Treat the Status YAML as your G2 sub-check 3 input.
   - **G2.5 (Re-verify):** re-execute the inlined auditor at sub-check 5 against the new HEAD.
5. Pause at each gate boundary for explicit maintainer confirmation
6. Refuse bypass attempts; respect refusal protocols
7. Tag only the G2.5-captured SHA at G3 per D22
8. Return gate-by-gate output throughout the flow

The "reference + execute inline" pattern is what enables cross-client compatibility for chain composition. Phase 2 GATE C sub-spike validates that this pattern is reliable.

## Critical Caveats for Non-Claude Inline Execution

Because non-Claude clients cannot natively chain, the auditor and curator behaviors run in the SAME context window as the conductor on non-Claude clients. This has implications:

1. **Context budget.** The combined token budget (conductor + inlined auditor + inlined curator + their child reads) may approach context limits on long releases. Plan accordingly.
2. **Tool authorization.** The conductor's tool list includes Bash, Read, Edit, Grep, Glob, Agent. The auditor needs Bash + Read + Grep + Glob. The curator needs Bash + Read + Grep. Inline execution on non-Claude clients should have access to ALL of these (i.e., not be running in a Read-only mode).
3. **Refusal cascade.** If the inlined auditor refuses (e.g., validators not invocable), the conductor's G0 sub-check 5 fails and the gate pauses. Same for the curator at G2.

## Reference Files

- Canonical sub-agent definition: [`agents/pm-release-conductor.md`](../../agents/pm-release-conductor.md)
- Canonical runbook: [`docs/contributing/release-runbook.md`](../../docs/contributing/release-runbook.md)
- Behavioral spec: [`docs/internal/release-plans/v2.16.0/spec_pm-release-conductor.md`](../../docs/internal/release-plans/v2.16.0/spec_pm-release-conductor.md)
- Chain child (inlined at G0 + G2.5): [`agents/pm-skill-auditor.md`](../../agents/pm-skill-auditor.md)
- Chain child (inlined at G2): [`agents/pm-changelog-curator.md`](../../agents/pm-changelog-curator.md)
- Pre-tag validator bundle: `scripts/pre-tag-validate.{sh,ps1}`
- Runtime components catalog: [`docs/reference/runtime-components.md`](../../docs/reference/runtime-components.md)
- Output template: `references/TEMPLATE.md`
- Worked example: `references/EXAMPLE.md`

© product-on-purpose · Apache-2.0 · product-on-purpose/pm-skills

Similar skills

All skills for DevOps and infrastructure →

From the same set68

tool-design-sprint-brief Builds a two-page brief before a Design Sprint starts: challenge, questions, roles, customer recruiting, prototype medium and success criteria. CX Codex +1 617installs tool-design-sprint-sketch Runs day two of a Design Sprint: lightning demos plus the four-step independent sketch protocol. Useful for a facilitator once Monday's target is locked. CX Codex +1 616installs utility-pm-skill-auditor Runs every validator across the repo, re-derives aggregate counters and surfaces cross-cutting issues that no single validator catches. CX Codex +1 601installs utility-pm-changelog-curator Builds a CHANGELOG draft from git log between tags and applies the repo hygiene rules. Useful right before a release. CX Codex +1 597installs foundation-prioritized-action-plan Turns messy notes and Slack threads into an evidence-grounded PM action plan using Theory of Constraints and Cynefin. CX Codex +1 581installs utility-pm-workflow-orchestrator Runs an ordered chain of pm-skills against one input, pauses for go/no-go, and stops when a step fails or comes back empty. CX Codex +1 541installs utility-pm-workflow-builder Takes a workflow idea to a review-ready packet: a draft workflow file, a draft slash command and an update checklist. Useful when a repeated skill chain should become durable. CX Codex +1 483installs foundation-stakeholder-briefings Turns any source spec or note into a neutral master document with numbered claims, then projects tailored briefing blocks for engineering and leadership. CX Codex +1 428installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor