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.zip

Installs 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 passes
70 charsno explicit “when” trigger
Intermediate

Key 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

You give it
The current local completion after `/gsd-verify-work` passes.
You get back
A created pull request on GitHub, ready for review and merge.

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-ship as {{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:

  • headerheader
  • questionquestion
  • Options formatted as "Label" — description{label: "Label", description: "description"}
  • Generate id from header: lowercase, replace spaces with underscores

Batched calls:

  • AskUserQuestion([q1, q2]) → single request_user_input with multiple entries in questions[]

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_input is 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: false by 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>
<objective> Bridge local completion → merged PR. After /gsd-verify-work passes, ship the work: push branch, create PR with auto-generated body, optionally trigger review, and track the merge.

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.

SkillInstallsUpdatedSafetyDifficulty
gsd-ship (this skill)04moNo flagsIntermediate
fix-pr14moReviewIntermediate
resolve-checks16moReviewIntermediate
agent-github-pr-manager16moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry