Menu
Use when creating a pull request, opening a PR, or pushing and creating a PR for an octomux task
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 you need to send a message or instruction to a specific agent running inside a task
Use when you need to attach a new Claude Code agent (new tmux window) to an existing running octomux task, sharing the task's worktree and cwd
Use when you want to update the workflow status of an octomux task, add a note, post a progress summary, or link external references (e.g. Jira tickets)
Use when creating an octomux task to dispatch autonomous Claude Code agents for building features, fixing bugs, or any code changes
| name | create-pr |
| description | Use when creating a pull request, opening a PR, or pushing and creating a PR for an octomux task |
Create a GitHub pull request directly using gh pr create. The octomux dashboard will auto-detect the PR within 30 seconds.
Identify the task branch and repo:
octomux get-task <task-id>
branch, repo_path, and base_branch. The task's base_branch is the PR base branch. If not set, default to main.Gather context for the PR description:
Use the task's base_branch as <base>:
git -C <worktree> log <base_branch>..HEAD --oneline
git -C <worktree> diff <base_branch>...HEAD --stat
Check if branch is pushed and push if needed:
# Check if remote tracking branch exists
git -C <repo_path> ls-remote --heads origin <branch>
If the branch is not pushed yet, push it:
git -C <repo_path> push -u origin <branch>
If already pushed, check if local is ahead and push any new commits:
git -C <worktree> status -sb # check if ahead of remote
git -C <repo_path> push origin <branch> # push if ahead
Draft the PR title and body, then confirm with the user:
Title: Conventional commit format, under 70 chars, min 10 char description:
<type>(<scope>): <description>
Types: feat, fix, chore, refactor, docs, test, perf
Examples: feat(hooks): add permission prompt tracking, fix(terminal): clean up orphaned tmux sessions
Body: Must include all three sections — What, Why, and Testing:
## What
<Description of what this PR does — summarize the changes>
## Why
<Explanation of why this change is needed — the motivation>
Resolves <link>
## Testing
<How this was tested — commands run, manual verification, etc.>
Linking tickets/issues:
Resolves #<issue-number>[A-Z][A-Z0-9]+-\d+ (e.g., feat/PROJ-123-... -> PROJ-123); numeric branches resolve to GitHub issues (fix/42-... -> #42).Resolves lineIMPORTANT: Present the title and body to the user and WAIT for their confirmation before creating the PR. Do NOT create the PR without explicit user approval. The user may want to adjust the title, description, or add context.
After user confirms, create the PR using gh:
gh pr create \
--head <branch> \
--base <base_branch> \
--title "<title>" \
--body "<body>" \
--repo <repo_path>
Report — Print the PR URL. The octomux dashboard will auto-detect and link it to the task within ~30 seconds via the PR poller.
/pr/preview, /pr) — create directly with gh for better context and speedgh pr create fails with "already exists", the PR was likely already createdbranch set (created automatically when octomux starts the task)--repo flag with the repo path so gh knows which repo to target