Agent skill · gstack
/ship Take a branch from finished code to an open PR
Ship runs the release path for a feature branch in one command. It merges the base first, runs tests and coverage checks, reruns the review and an adversarial pass, bumps the version and changelog, audits docs, commits in bisectable chunks, verifies the frozen content again, then pushes and opens the PR. Routine choices are automatic; conflicts and risky findings stop for you.
Works with
- Claude Code
- Codex, Cursor, OpenCode, Gemini CLI and other agents
Used forDeployment and git
When to use it
- A feature is done and you want tests, review and release notes handled together.
- You want the version bump and changelog chosen consistently from the diff.
- You need a final check that nothing changed after tests and review passed.
How it works
- 1Pre-flight and merge
The agent refuses to ship from the base branch, fetches it and merges it in before any tests run.
- 2Test and review
It runs the test suites, audits coverage and plan completion, then runs the pre-landing and adversarial reviews.
- 3Prepare the release
It picks the version bump, updates CHANGELOG and TODOS, audits docs and commits in bisectable pieces.
- 4Verify frozen content
No completion claim is allowed without fresh evidence; any later code change sends it back through tests and review.
- 5Push and publish
It pushes the branch, opens or updates the PR and records ship metrics.
What it steers the agent away from
- Claiming success without fresh verification evidence.
- Duplicate version bumps, pushes or PRs on reruns.
- Committing generated tests that fail.
Install this skill
It installs with the gstack pack.
Claude CodeThe README wraps this command in a prompt you paste into Claude Code, which also adds a short gstack section to CLAUDE.md.
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setupClaude Code (team mode for a shared repo)Run inside your repo; it commits a bootstrap so teammates get gstack with auto-updates, and needs Node.js for the required hook.
(cd ~/.claude/skills/gstack && ./setup --team) && ~/.claude/skills/gstack/bin/gstack-team-init required && git add .claude/ CLAUDE.md && git commit -m "require gstack for AI-assisted work"Codex, Cursor, OpenCode, Gemini CLI and other agentsUse --host auto for every detected agent or name one host; non-Claude hosts are listed as experimental.
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/gstack
cd ~/gstack && ./setup --host auto # or: ./setup --host codex
./setup --status # one row per install: host, tier, scope, version, pathCommands come from the author’s README; check it for changes before you run them.
Questions
Does it ask before every step?
No. Routine work such as including uncommitted changes, small version bumps and changelog drafts proceeds without asking; complex conflicts and blocking findings stop for your answer.
What happens if I change code after review?
The verification stage detects the change and routes back through tests and review before anything is pushed.
More guides from gstack
/csoRun a security audit that keeps evidence separate from claimsAudits code, infrastructure, supply chain or skills for exploitable defects, challenges each finding and can reproduce fixes in Docker.Read the guide →/office-hoursPressure-test an idea before your agent writes any codeQuestions your idea in startup or builder mode, challenges premises, compares two or three approaches and writes a design doc, with no code.Read the guide →/plan-ceo-reviewReview a plan for scope and ambition like a founderReviews a plan as a founder would, in expansion, selective, hold or reduction mode, and asks before adding or cutting any scope.Read the guide →/plan-eng-reviewLock architecture, edge cases and tests before you buildLocks a plan's architecture, data flow, edge cases and test coverage, with ASCII diagrams and a review report appended to the plan.Read the guide →/qaFind, reproduce and fix bugs with regression testsTests a site, API, CLI, job or webhook, reproduces each bug, writes a regression test first and commits each verified fix.Read the guide →/reviewCatch production bugs in a diff before it mergesReviews a branch diff for bugs that pass CI, dispatches specialist and adversarial passes, auto-fixes obvious issues and asks about the rest.Read the guide →
Also in this pack
/autoplanRuns the CEO, design, developer experience and engineering reviews in sequence and brings only taste decisions to you.↗/benchmarkMeasures page load timings, Core Web Vitals and resource sizes in a real browser and compares them with a saved baseline.↗/browseDrives a real browser, preferring your signed-in Aside sessions, to open pages, click through flows, read the console and take screenshots.↗/canaryWatches a live URL after a deploy for console errors, failed pages and visual changes against baseline screenshots.↗/carefulWarns before destructive commands such as recursive deletes, dropped tables or force pushes, and hard-blocks the riskiest ones.↗/codexGets an independent review, challenge or consultation from the OpenAI Codex CLI and presents its output unedited.↗/design-consultationResearches your product space and proposes a full design system, written to a DESIGN.md file with font and colour previews.↗/design-htmlTurns an approved mockup into production HTML and CSS with computed text layout, detecting React, Svelte or Vue.↗/design-reviewAudits a live site for spacing, hierarchy and generated-looking patterns, then fixes them with atomic commits and before and after screenshots.↗/design-shotgunProduces several AI design mockups side by side in a browser board, collects your feedback and iterates until you pick a direction.↗/devex-reviewTests a developer product live by following its docs and getting-started flow, timing each step and comparing against the plan's scores.↗/diagramTurns an English description into a mermaid source, an editable Excalidraw file and rendered SVG and PNG, offline.↗
Summary by trendhub. The skill itself lives in garrytan/gstack/ship by Garry Tan (MIT); read the full, current text there.