release-playbook

release-playbook is a skill for Claude Code, Codex from makifbaysal/tasktrooper. It costs 42 tokens per session (1,587 once invoked), scanned A, original, Apache-2.0.

An end-to-end release procedure covering merge, deployment, observation, and the final decision. It explains how different release modes work, including code that deploys on merge, human-cut batches, and components with nothing to deploy.

In plain words
What is it for?
Use it to move an approved task through merging, deployment, watching, and either completion or rollback. It also handles unusual results such as a refusal, an existing tag, or an unconfirmed release.
Why use it?
Release work can go wrong when steps are skipped or when the next action is guessed from an unexpected tool result. This playbook keeps the delivery sequence and decision points explicit.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to move an approved task through merging, deployment, watching, and either completion or rollback. It also handles unusual results such as a refusal, an existing tag, or an unconfirmed release.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/makifbaysal/tasktrooper/release-playbook
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add makifbaysal/tasktrooper --skill release-playbook
Clone the repo
git clone --depth 1 https://github.com/makifbaysal/tasktrooper

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for release-playbook

README.md
[![agentmods](https://agentmods.dev/badge/skills/makifbaysal/tasktrooper/release-playbook/github.svg)](https://agentmods.dev/skills/makifbaysal/tasktrooper/release-playbook)
Your own site
<a href="https://agentmods.dev/skills/makifbaysal/tasktrooper/release-playbook"><img src="https://agentmods.dev/badge/skills/makifbaysal/tasktrooper/release-playbook/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for release-playbook

Your own site · 80×15
<a href="https://agentmods.dev/skills/makifbaysal/tasktrooper/release-playbook"><img src="https://agentmods.dev/badge/skills/makifbaysal/tasktrooper/release-playbook.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 42 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,587 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00042 $0.01587
Opus 5.5 $0.00017 $0.00635
Sonnet 5.5 $0.00008 $0.00317
Haiku 4.5 $0.00004 $0.00159

Measured 8d ago against content hash 61ff6bad4575, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

release-playbook scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

catalog/agents/release-engineer/skills/release-playbook/SKILL.md · 111 lines

How it starts

The opening of the file, as written. The whole thing — 111 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Release playbook

You own a task from the moment the board signs it off in done until it either lands in released or bounces back to need_revision through a rollback. Four steps, in order, and each is only worth doing because the one before it happened: merge → deploy → watch → finish or roll back.

1. Merge

merge_task_pull_request({ task_id })

returns, among the usual merge fields, release:

{
  "release": {
    "mode": "dispatch",
    "release_id": "b1e2...",
    "status": "pending",
    "next": "call deploy_release, then watch_release"
  }
}

release.next already tells you the next call — read it, do not guess. release.unconfirmed: true is a flag on a task merged some other way, not a fifth mode — stop, the card already says why. The modes:

release.mode What it means What you do
none Nothing deploys this component (a library, docs) — the merge itself was the release. Nothing.
batch This component (desktop, mobile and friends) ships in a human-cut batch: the merge joined the component's draft release. Nothing — the task stays in done until a human cuts it.
on_merge The merge itself deploys (a workflow on push, or a provider's git integration). watch_release.
dispatch A deploy workflow needs to be dispatched at the release tag. deploy_release, then watch_release.

A merge refusal is final, not a retry — see the refusal table in your done column.

2. Deploy

deploy_release({ task_id })

dispatch mode dispatches the profile's workflow at the release tag (release/<sha12>) and moves the release to deploying. Then call watch_release.

A cut batch release (status pending, mode batch — you are woken with it, you never cut it) does something different per executor:

Executor What deploy_release does
github_actions Creates the release tag at the cut commit; the repository's own tag-triggered workflow builds and publishes. A tag that already exists is a real refusal here — unlike dispatch, a batch version is never re-used (SemVer §3: a released version's contents never change). Comment "tag vX.Y.Z already exists — re-cut this release with a new version on the Deploy tab" instead of retrying.
local Runs the profile's command on this machine, in a detached worktree of the cut commit, and logs it (local_run on the release).
store Starts a store build for every platform the repository has a linked app for (store_builds on the release).

Read the full file on GitHub · 111 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 111 lines · 42 tokens per session scan A 61ff6bad4575

Subscribe to this mod's changes

release-playbook is a skill published in the GitHub repository makifbaysal/tasktrooper (113 stars, last pushed yesterday), licensed Apache-2.0. It adds 42 tokens to every session and 1,587 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-05.