GitHub PR Workflow

• You have local changes ready to ship and want a branch created, commits staged, and a PR opened with a structured description in one flow.
• You need to monitor CI check runs on an open PR and want failing logs surfaced automatically without watching the GitHub UI.
• You want an auto-fix loop: detect a failing lint or test check, apply a fix, push, and re-poll until all checks go green.
• You're ready to merge and want a specific strategy (squash, rebase, or merge commit) applied and the source branch deleted afterward.

• You are not working in a git repository with GitHub as a remote — this skill assumes that setup throughout.
• You do not have the gh CLI authenticated or a GitHub PAT available; without one of those, API calls will fail.
• You need to manage GitLab, Bitbucket, or other non-GitHub remotes — the skill is GitHub-specific.

Automatically creates a feature branch with a conventionally named slug and stages your changes with a generated commit message. Keeps your commit history clean without requiring you to write messages manually.

Pushes the branch to origin and opens a pull request using a built-in description template (references/pr-template.md). Supports reviewer requests, label assignment, and issue linking in the same step.

Polls GitHub check runs via scripts/watch_ci.sh and prints the logs of any failing checks directly to your session. No more clicking through the Actions UI to find the error.

When a check fails, the skill can apply a fix, push the new commit, and re-poll checks — repeating the cycle until all required checks pass. Saves back-and-forth pushes when dealing with linting or formatting failures.

Supports squash merge, rebase merge, and standard merge commits. After merging, it deletes the source branch to keep the remote tidy.

Uses the gh CLI as the primary driver when it is authenticated. If gh is unavailable, references/api-fallback.md and curl-based scripts handle all operations against the GitHub REST API using $GITHUB_TOKEN.

A developer has local changes and asks: "Open a PR titled 'Add rate limiting to /api/search' targeting main." The skill creates the branch, stages commits, pushes, and opens the PR with a description — no manual git commands needed.

After opening a PR, a developer asks: "Watch the PR checks, and if lint fails, fix and push again." The skill polls check runs, detects the lint failure, applies the fix, pushes, and re-checks until the suite is green.

When review is approved, a developer asks: "Squash-merge PR #142 and delete the branch." The skill executes the squash merge and removes the remote branch in one action.

A developer asks: "Review my branch — what checks are failing and who hasn't approved yet?" The skill surfaces current CI status and outstanding reviewer approvals from the GitHub API.