land-and-deploycommit a77fae2 · v1.0.0SKILL.md · Deploy & Release
Land and Deploy
Picks up the GitHub PR from /ship: checks CI and readiness, merges after approval, monitors the deploy, verifies production and writes a report.
It merges PRs, deletes branches and pushes revert commits to the base branch on rollback; requires an authenticated gh and supports GitHub only.
npx skills add garrytan/gstack --skill land-and-deployCommand selected. Copy it manually.
- Permissions
- read-repo
- write-files
- shell
- network
- Compatible with
- Claude Code, Codex, Cursor, Copilot
- GitHub
- 138.5k
- Source
- Community · Garry Tan
- Status
- Scan passed
- License
- MIT
- Category
- Deploy & Release
Core rule
Never force-push, bypass CI, replay a confirmed merge, or hide missing evidence.
Execution Phases
Phase 01Pre-flight
Confirm gh auth, find the PR and base branch, require a clean checkout matching the PR head, and run a dry-run validation on first use.
Phase 02CI and readiness
Gate on all CI checks for the head, merge conflicts and VERSION drift, waiting for CI if pending, then pass the pre-merge readiness gate.
Phase 03Merge and wait
Merge after approval, detect the deploy strategy, and confirm the matching revision deployed via GitHub Actions or platforms like Fly.io or Heroku.
Phase 04Canary verification
Check the production URL's health; on failure, roll back with revert commits only after the user explicitly chooses to.
Phase 05Deploy report
Pick a verdict from the evidence, such as DEPLOYED AND VERIFIED or MERGED (UNVERIFIED), save it to .gstack/deploy-reports/ and suggest follow-ups.
Permissions (summarised from SKILL.md)
| Capability | Needed | Details |
|---|---|---|
| File writes | Limited | Writes deploy reports and temp files under .gstack/ plus confirmation markers and logs in the gstack state directory; it does not edit code before merging. |
| Command execution | Required | Runs git, gh, jq, gstack helper scripts and platform status commands like fly or heroku, including merge, revert and push. |
| Network outbound | Limited | Talks to GitHub (gh, git fetch/push), deploy platform status endpoints and the production URL being verified, and logs gstack telemetry. |
SKILL.md frontmatter (YAML)
---
name: land-and-deploy
preamble-tier: 4
version: 1.0.0
description: Land and deploy workflow. (gstack)
allowed-tools:
- Bash
- Read
- Write
- Glob
- AskUserQuestion
triggers:
- merge and deploy
- land the pr
- ship to production
---