gsd-ship
Automate the end-to-end pull request lifecycle.
Install
mkdir -p .claude/skills/gsd-ship && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12557" && unzip -o skill.zip -d .claude/skills/gsd-ship && rm skill.zipInstalls to .claude/skills/gsd-ship
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Create PR, run review, and prepare for merge after verification passesKey capabilities
- →Create a pull request with an auto-generated body.
- →Optionally trigger a review for the pull request.
- →Track the merge status of the pull request.
- →Bridge local completion to a merged PR.
- →Prepare for merge after verification passes.
How it works
The skill executes a ship workflow that pushes the branch, creates a pull request with an auto-generated body, and prepares it for merge after verification passes.
Inputs & outputs
When to use gsd-ship
- →Shipping a finished feature
- →Submitting a bug fix
- →Automating merge workflows
About this skill
<codex_skill_adapter>
A. Skill Invocation
- This skill is invoked by mentioning
$gsd-ship. - Treat all user text after
$gsd-shipas{{GSD_ARGS}}. - If no arguments are present, treat
{{GSD_ARGS}}as empty.
B. AskUserQuestion → request_user_input Mapping
GSD workflows use AskUserQuestion (Claude Code syntax). Translate to Codex request_user_input:
Parameter mapping:
header→headerquestion→question- Options formatted as
"Label" — description→{label: "Label", description: "description"} - Generate
idfrom header: lowercase, replace spaces with underscores
Batched calls:
AskUserQuestion([q1, q2])→ singlerequest_user_inputwith multiple entries inquestions[]
Multi-select workaround:
- Codex has no
multiSelect. Use sequential single-selects, or present a numbered freeform list asking the user to enter comma-separated numbers.
Execute mode fallback:
- When
request_user_inputis rejected (Execute mode), present a plain-text numbered list and pick a reasonable default.
C. Task() → spawn_agent Mapping
GSD workflows use Task(...) (Claude Code syntax). Translate to Codex collaboration tools:
Direct mapping:
Task(subagent_type="X", prompt="Y")→spawn_agent(agent_type="X", message="Y")Task(model="...")→ omit (Codex uses per-role config, not inline model selection)fork_context: falseby default — GSD agents load their own context via<files_to_read>blocks
Parallel fan-out:
- Spawn multiple agents → collect agent IDs →
wait(ids)for all to complete
Result parsing:
- Look for structured markers in agent output:
CHECKPOINT,PLAN COMPLETE,SUMMARY, etc. close_agent(id)after collecting results from each agent </codex_skill_adapter>
Closes the plan → execute → verify → ship loop. </objective>
<execution_context> @/home/lnayyar/projects/CourseAIVibeCodeUdmey/finally/.codex/get-shit-done/workflows/ship.md </execution_context>
Execute the ship workflow from @/home/lnayyar/projects/CourseAIVibeCodeUdmey/finally/.codex/get-shit-done/workflows/ship.md end-to-end.
When not to use it
- →When `/gsd-verify-work` has not passed.
- →When the user wants to fork context for subagents.
Limitations
- →It requires `/gsd-verify-work` to pass.
- →It does not select models inline.
- →It does not fork context by default.
How it compares
This skill automates the final steps of the development cycle, from local completion to a merged PR, by integrating push, PR creation, and review triggering, which is more simplify than manual execution.
Compared to similar skills
gsd-ship side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| gsd-ship (this skill) | 0 | 4mo | No flags | Intermediate |
| fix-pr | 1 | 4mo | Review | Intermediate |
| resolve-checks | 1 | 6mo | Review | Intermediate |
| agent-github-pr-manager | 1 | 6mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by lalitnayyar
View all by lalitnayyar →You might also like
fix-pr
AztecProtocol
Fix a failing PR by analyzing CI logs and fixing errors. Autonomous workflow that identifies failures, rebases, fixes issues, and pushes.
resolve-checks
flowglad
Resolve all failing CI checks and address PR review feedback on the current branch's PR. Runs tests locally, fixes failures, incorporates valid review comments, and resolves addressed feedback. Use when CI is red, after receiving PR feedback, or before merging.
agent-github-pr-manager
ruvnet
Agent skill for github-pr-manager - invoke with $agent-github-pr-manager
agent-github-modes
ruvnet
Agent skill for github-modes - invoke with $agent-github-modes
agent-pr-manager
ruvnet
Agent skill for pr-manager - invoke with $agent-pr-manager
git-pr-workflows-git-workflow
sickn33
Orchestrate a comprehensive git workflow from code review through PR creation, leveraging specialized agents for quality assurance, testing, and deployment readiness. This workflow implements modern g