git-workflow-pr

Guides opening, drafting, and verifying GitHub pull requests with task-linked titles and checklists.

1|Updated Jan 14, 2024
One-click install
npx skills add https://github.com/Eyhenij/rt-tools --skill git-workflow-pr-eyhenij
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-workflow-pr
Source: https://github.com/Eyhenij/rt-tools/tree/main/.claude/skills/git-workflow-pr
Command: npx skills add https://github.com/Eyhenij/rt-tools --skill git-workflow-pr-eyhenij

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Opening a pull request involves many easy-to-miss steps — title format, draft state, base branch, reviewer assignment, and pre-publish checks — and silent failures (like GitHub dropping a reviewer request) leave work waiting for a review nobody was asked to give. ## Core Features & Use Cases - PR Title and Branch Conventions: Enforces the [<KEY>-<number>] <what was done> title format matching the task and branch name, keeping commit type/scope out of the PR title. - Draft vs. Ready Workflow: Reads the CI pipeline file to decide whether the PR opens as a draft (pipeline runs on that base) or directly, and lifts the draft with gh pr ready only when checks pass. - State Verification: Re-reads PR state via the GitHub API after reviewer/label calls and before reporting anything, since return codes can be zero even when nothing happened. - Pre-Publish Checklist: A 15-item checklist covering base freshness, diff scope, builds, translations, PR body sections, and board column moves. - Use Case: An agent finishing a task branch uses this pattern to open a draft PR against the epic branch, verify the reviewer and labels were actually set, pass the checklist, lift the draft, and move the task to in-review. ## Quick Start Open a pull request for the current branch following the git-workflow-pr pattern, including title format, draft handling, and the pre-publish checklist.

Frequently Asked Questions about git-workflow-pr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I open a GitHub pull request as a draft with gh CLI?

Use `gh pr create --draft --base <branch> --title '<title>' --body-file <file>` to open a draft PR. Lift the draft later with `gh pr ready <number>` once checks pass and the work is ready for review.

How should a pull request title reference a task number?

Use the format `[<KEY>-<number>] <what was done>`, matching the task and branch name. State the completed result rather than the task's infinitive, and omit commit type and scope prefixes like `fix:` or `docs:`.

Why does a GitHub PR have no reviewer after requesting one?

GitHub silently drops a review request when the requested reviewer is the PR author, returning a zero exit code. Re-read the PR state with the API to confirm reviewers, labels, and author after setting them.

When should a pull request be opened as a draft?

Open a draft when the CI pipeline runs on the target base branch, so the draft lifts only after a green run. Read the pipeline file to see which bases trigger it; if the base is not covered, open the PR directly without a draft.

What should be checked before publishing a pull request?

Verify the base branch is merged in, the diff contains only the intended edit with no mocks or debug lines, all applications build, translations are complete, the PR body follows the required sections, and the PR state was read from the API rather than assumed.