release
Skill5 starsChanged 31 days agoMITView on GitHub
Ship to production. The single "ship it" verb for any project, handling both PR mode (merges open PRs targeting main) and trunk mode (commits straight to main). Updates README.md + project CLAUDE.md, pushes to all remotes, verifies the auto-deploy (Render / Vercel / etc.), and rebuilds the local Docker container so localhost matches prod. Triggers on "release", "ship it", "deploy", "ship to prod", "merge and release", "push to prod".
- Reads credentials
- Commits and pushes
193 other projects use a version of this.
Adopted by
Most recently taken up by
- naomiaro/waveform-playlisttheir own version, first seen Nov 16, 2026
- osmlab/name-suggestion-indextheir own version, first seen Nov 16, 2026
- vulnerability-lookup/vulnerability-lookuptheir own version, first seen Nov 16, 2026
- ClickHouse/mcp-clickhousetheir own version, first seen Nov 16, 2026
- bpatrik/pigallery2their own version, first seen Nov 16, 2026
- Shasnow/StarRailAssistanttheir own version, first seen Nov 16, 2026
Used with
Projects with it also use create-agent-adapter, changelog-style and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
MicrosoftSkillcreate-agent-adapter
Technical guide for creating a new Paperclip agent adapter. Use when building a new adapter package, adding support for a new AI coding tool (e.g. a new CLI agent, API-based agent, or custom process), or when modifying the adapter system. Covers the required interfaces, module structure, registration points, and conventions derived from the existing claude-local and codex-local adapters.
Also in 5 projects that use this
GrinvSkillchangelog-style
Turn a commit range into CHANGELOG.md entries following common-changelog style. Use when finishing a PR or cutting a release, to write/fix the [Unreleased] section's entries — moving [Unreleased] under a new dated version heading is a separate, automated step (see the release skill / scripts/sync-version.ts), not this skill's job.
Also in 4 projects that use this
Microsoft AzureSkillcomponent-release
Prepares a verifiable Agent Landing Zone UI release. Use for release branches, VERSION, changelog entries, tags, release notes, and compatibility evidence; never publish without explicit human approval.
Also in 4 projects that use this
GrinvSkilldocs-consistency-check
Check README/manifest.json/server.json/CHANGELOG.md/AGENTS.md and docs/*.md for drift against the actual registered tools and source. Use after adding, renaming, or removing a tool, or as part of a live-audit pass.
Also in 4 projects that use this
Microsoft AzureSkilldocumentation-consistency
Keeps AI Landing Zone contributor, user, and operator documentation aligned with shipped Bicep behavior. Use for parameters, defaults, outputs, topology, deployment flow, operations, or releases.
Also in 8 projects that use this
parcadeiSkillagent-context-isolation
Agent Context Isolation
Also in 3 projects that use this
- +3 more from Grinv
Other versions193 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 193
- paperclipai/paperclip★ 114ksame name
- modelcontextprotocol/servers★ 92ksame name
- remotion-dev/remotion★ 73ksame name
- traefik/traefik★ 66ksame name
- usememos/memos★ 64ksame name
- tw93/Pake★ 64ksame name
- AmruthPillai/Reactive-Resume★ 46ksame name
- amruthpillai/reactive-resume★ 46ksame name
- reactive-resume/reactive-resume★ 46ksame name
- Yeachan-Heo/oh-my-claudecode★ 41ksame name
183 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository2 other files it gives its agents.
- pr-checkpointSkill
- review-roundSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
16 rules. 0 are common, 7 are distinctive, and 9 are very specific to this project.
0
Common
Most of the 183 edited versions we read keep these.
7
Distinctive
This author's own choices. Worth a look.
9
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- could be automatic: a setting could enforce it
- Distinctive: line 16
Read the branch, the open PRs and the project profile, and pick PR mode or trunk mode.
- Distinctive: line 28
If there are 2+ PRs, ask which to merge (default: all).
- Very specific: line 51
Stop on unresolved Blockers, and certify each PR only on an exact CLEAN @ <head sha> review verdict.
- Very specific: line 86
Commit message: use $ARGUMENTS as the subject if provided.
- Distinctive: line 89
If working tree is already clean, skip.
- Distinctive: line 118
Run the repository's own pre-push gate, when it has one, and BLOCK on failure.
- Very specific: line 124
Follow ~/.claude/skills/_shared/release-docs.md: write a real subsection explaining the change, update the project CLAUDE.md with technical …
- Very specific: line 126
Commit the docs (separate commit is fine: docs: README and CLAUDE.md for <change-name>).
- Very specific: line 144
Follow ~/.claude/skills/_shared/local-docker-rebuild.md: rebuild from the current base branch so localhost matches prod.
- Distinctive: line 162
Commit hash(es) on the base branch
- Very specific: line 171
Never force-push unless explicitly asked.
- Distinctive: line 172
Never amend a published commit.
- Very specific: line 173
Never skip hooks with --no-verify.
- Very specific: line 174
Never gh pr merge --admin (bypassing branch protection) unless explicitly asked.
- Very specific: line 177
Never merge a PR whose own head this run has not scanned, and never let a failed checkout, fetch or ref read continue as an advisory.
- Distinctive: line 185
Never report a release as complete without stating its verdict status.
“Common” is measured: kept by at least 6 in 10 of the 183 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Release (ship to production)
The single "ship it" verb. This skill takes whatever state the repo is in (open PRs on feature branches, commits sitting on main, uncommitted work in the working tree) and ships it to production atomically.
For the iterate / checkpoint stage (open a PR for local testing, no merge, no prod deploy), use /pr-checkpoint instead.
Step 0: Detect release shape
Read the branch, the open PRs and the project profile, and pick PR mode or trunk mode.
Read ~/.claude/skills/release/reference/step0-detect-shape.md now, in full, and follow it. It is this step's full text; the line above is only a summary and is not enough to act on.
Path A: PR mode
A1. List the PRs
Show each open non-draft PR against main with: number, title, head branch, mergeability. Surface drafts separately as "skipping unless confirmed."
A2. Confirm if more than one PR
If there are 2+ PRs, ask which to merge (default: all). One PR → proceed.
A2b. One iteration per PR, never a batch
A3, A3b and A4 are ONE iteration and it runs once per selected PR, in the order A1 listed them. Every merged head must be the head that was scanned, so no PR is merged until its own iteration has scanned it:
- A3: read THAT PR's verdict and pin
CANDIDATE_SHAfrom its head. - A3b:
gh pr checkoutit, verifygit rev-parse HEADequals that pin, and STOP the release on a mismatch. Then scan--since="$BASE_SHA". - A4: re-read
origin/$BASEagainst$BASE_SHAand STOP if it moved, then merge THAT PR and no other. - Re-pin
BASE_SHAfrom the neworigin/$BASE, then begin the next PR's iteration.
One CANDIDATE_SHA and one scan cannot certify two PRs, and batching breaks both ways:
the second PR merges on the first one's verdict with its own head unscanned, and the base
re-read then fires a BASE MOVED the first merge caused itself, which reads as somebody
else's push. Never reuse a scan verdict for a second PR, and never merge two PRs between
one BASE_SHA pin and the next.
A3. Refuse if any selected PR has blockers
Stop on unresolved Blockers, and certify each PR only on an exact CLEAN @ <head sha> review verdict.
Read ~/.claude/skills/release/reference/a3-blockers-and-verdict.md now, in full, and follow it. It is this step's full text; the line above is only a summary and is not enough to act on.
A3b. Security scan and gate, BEFORE any merge or pull
Scan what this release changes, on the PR head, before anything is merged or pulled, and apply the gate.
Read ~/.claude/skills/release/reference/a3b-security-scan.md now, in full, and follow it. It is this step's full text; the line above is only a summary and is not enough to act on.
A4. Merge this iteration's PR
Re-read the base branch first, refuse if it moved, then merge this one PR and pull.
Read ~/.claude/skills/release/reference/a4-merge.md now, in full, and follow it. It is this step's full text; the line above is only a summary and is not enough to act on.
A5. Update docs on main
You are now on main with the merged code. Continue to the shared docs + push + deploy + Docker flow below (steps 1-5).
Path B: Trunk mode
B1. Assess
git status
git diff
git log --oneline -5
git remote -vB2. Commit if needed
- Stage specific files by name (never
git add -Aorgit add .) - Refuse to commit secrets or
.envfiles - Commit message: use
$ARGUMENTSas the subject if provided; otherwise summarize the changes - End with the Co-Authored-By trailer per the global Bash instructions
If working tree is already clean, skip.
B2b. Security scan and gate, on the commit you just made
The change is a commit now, so scan the commit range, and run this BEFORE the push in step 2. Pin the candidate and reuse the base SHA from step 0:
CANDIDATE_SHA=$(git rev-parse HEAD)
bash ~/.claude/skills/_shared/security-scan.sh --since="$BASE_SHA" "$(git rev-parse --show-toplevel)"Never --staged here. B2 has already committed, so the index is empty and --staged
scans nothing and returns NOTHING TO SCAN, which is exit 2 and reads like a green step.
The same trap in the other direction is why --since takes $BASE_SHA rather than
anything resolved now: a range computed after the push would compare the base branch with
itself.
A3b owns the exit codes, the [NEW] versus [PRE-EXISTING] split, the gate and the
waiver register. Read them there and apply them here; this step only says WHEN to run.
A blocking finding still costs nothing to act on, because the commit is local and
unpushed.
B3. Continue to shared docs + push + deploy + Docker flow below.
Shared: docs, push, deploy, Docker
0. Pre-push gate
Run the repository's own pre-push gate, when it has one, and BLOCK on failure.
Read ~/.claude/skills/release/reference/shared0-pre-push-gate.md now, in full, and follow it. It is this step's full text; the line above is only a summary and is not enough to act on.
1. Update README.md and project CLAUDE.md
Follow ~/.claude/skills/_shared/release-docs.md: write a real subsection explaining the change, update the project CLAUDE.md with technical details + gotchas, never push code without these.
Commit the docs (separate commit is fine: docs: README and CLAUDE.md for <change-name>).
2. Push to origin and its mirrors
Push to every remote, then prove each remote's LIVE ref holds the commit you pushed.
Read ~/.claude/skills/release/reference/shared2-push.md now, in full, and follow it. It is this step's full text; the line above is only a summary and is not enough to act on.
3. Verify auto-deploy landed the RIGHT commit (only when the repo deploys)
Confirm the live deploy runs the commit you pushed, after every deploy this release started has settled, not just that a deploy reports live.
Read ~/.claude/skills/release/reference/shared3-deploy-verify.md now, in full, and follow it. It is this step's full text; the line above is only a summary and is not enough to act on.
4. Rebuild local Docker
Skip this step when the repo has no Docker setup, and say in the final report that you skipped it and why.
Follow ~/.claude/skills/_shared/local-docker-rebuild.md: rebuild from the current base branch so localhost matches prod.
5. Final report
Single status block:
- Path taken (A merge / B trunk push)
- For path A: which PRs were merged + their numbers
- Verdict status per merged PR, one of:
CLEAN @ <sha>,no verdict comment (proceeded on your go-ahead), orstale verdict <sha> vs head <sha> (proceeded on your go-ahead). This line is mandatory and never omitted. Leaving it out is how an unreviewed merge came to read exactly like a reviewed one. - Security scan (A3b in PR mode, B2b in trunk mode): the mode, the
--sinceSHA, the file count, and one verdict, which isclean,N NEW findingsplus what was done about each,NOT APPLICABLE, no source file changed, orshipped UNSCANNED: <reason>, owner <name>, <YYYY-MM-DD>plus the tool that was missing. Never report exit 2 as a pass. - Security scan per merged PR in a multi-PR release: one line each, naming the PR and
the
--sinceSHA its own iteration used. One line for several PRs means one scan certified heads it never read. - Commit hash(es) on the base branch
- Which remotes were updated
- Mirror parity: the
sync-remotes.shverdict, orsingle remote, not applicable - Deploy verification: host URL + status +
live-commit == pushed-commitresult (name both SHAs if they differ) - Docker rebuild result line
- Clean working tree confirmed
Guardrails
- Never force-push unless explicitly asked. The one carve-out: retrying a rejected FEATURE-branch push after a rebase may use
--force-with-lease(never plain--force). This never applies to the base branch. - Never amend a published commit. Create a new commit.
- Never skip hooks with
--no-verify. - Never
gh pr merge --admin(bypassing branch protection) unless explicitly asked. - README and CLAUDE.md updates are part of this release, not a follow-up.
- Refuse to release with unresolved Blockers in any selected PR's
COMMENTS.md. - Never merge a PR whose own head this run has not scanned, and never let a failed
checkout, fetch or ref read continue as an advisory. One iteration per PR, re-pinning
BASE_SHAafter each merge (A2b). - Refuse to merge a PR whose
Review-round verdict:at the CURRENT head is CRITICALS-OPEN, absent an explicit override. Only an exactCLEANat the current head certifies; a missing, stale, advisory-checkpoint or unrecognised verdict is not a blocker, but it is never silent: surface it and wait for an explicit go-ahead (step A3). This skill never runs the reviewers itself. - Never report a release as complete without stating its verdict status. A merge with no verdict and a merge with a CLEAN verdict must not produce the same report.
- Refuse to commit secrets or
.envfiles. - Refuse to push Claude / AI-assistant harness files (
CLAUDE.md,MEMORY.md,AGENTS.md,.claude/,.cursor*,.aider*,.windsurf*,.github/copilot-instructions.md) to any remote you do not own. See~/.claude/skills/_shared/harness-files-protection.md. - Docker rebuild is best-effort: a failure here must NOT roll back the git push / merge. Report and continue.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

