Menu
Use after a PR is opened and you want it merged - waits for CI to pass, marks draft PRs ready, removes the worktree, then merges and cleans up
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when ready to implement - selects a GitHub Issue, creates worktree, implements with TDD, verifies, reviews 5x, and creates PR. Numeric argument (e.g. pick-issue 3) is the issue number, not a parallelism count.
Use when you want to be exhaustively questioned about a plan or design until shared understanding is reached - asks one question at a time, traverses the design tree, and proposes a recommended answer for each question
Use to delegate all hands-on work to Codex - plan-writing, implementation, and refactoring. Opus reads, thinks, reviews, and writes docs only.
Use when starting new feature work, adding functionality, or modifying behavior - explores design before implementation, creates plan, PR, and GitHub Issues
Use when encountering test failures, bugs, or unexpected behavior - requires root cause investigation before any fix attempt
Use when creating implementation plans from specs or design documents - decomposes work into concrete TDD tasks with file paths and code examples
| name | merge-when-ready |
| description | Use after a PR is opened and you want it merged - waits for CI to pass, marks draft PRs ready, removes the worktree, then merges and cleans up |
The final step of the workflow chain. After pick-issue has opened a PR (and review has passed), this skill waits for CI checks to pass and then merges the PR, handling worktree teardown and post-merge cleanup so the repo returns to a clean state on the main branch.
gh pr view --json number -q .number.--repo flag, or when on the main branch, you
MUST pass an explicit branch name:
gh pr view <branch-name> --json number -q .number --repo <owner>/<repo>.
gh pr view cannot infer the PR without an argument when --repo is used
or when the current branch is not the feature branch.gh pr checks <PR number>.gh pr checks every 30 seconds until all checks pass.gh pr ready <PR number>.git worktree remove .worktrees/<branch-name> (add --force
if it has a submodule), then git branch -D <branch-name>. Removing the
worktree and deleting the local branch prevents "branch used by worktree"
errors during merge.gh pr merge <PR number> --merge --delete-branch run from the
main worktree (the project root directory), NOT from a feature worktree.git pullgit remote prune origingh pr merge from the main worktree, not from a feature
worktree.gh pr merge, not after. This
prevents "branch used by worktree" errors.