antfu-create-pr
Installation
SKILL.md
Create Pull Request
Open a PR that a reviewer can understand from the body alone. Explain the changed behavior and why, not the list of changed files. Keep the body proportional to the change: a one-line fix gets a few sentences, a cross-module feature gets tables and diagrams.
Workflow
- Inspect the repo:
git status, current branch, remotes, default branch,.github/PULL_REQUEST_TEMPLATE*, andAGENTS.md/CONTRIBUTING.mdfor PR rules. - Compute the merge base against the target branch and record the exact
base...headrange the PR publishes. If the branch is stacked on another unmerged branch, target that branch and describe only this PR's own changes. - Read the full diff. Separate runtime code from generated files, lockfiles, and snapshots. Trace changed code to its entry points, callers, and external boundaries so architecture claims are backed by file paths or symbols.
- Classify the PR (feature, fix, refactor, chore, docs) and decide which optional body sections earn their place. See pr-body.
- Run the checks that match the changed surfaces (focused tests, typecheck, lint). Record the exact commands and results.
- If the diff changes user-visible UI, capture before/after evidence. See visual-evidence.
- Review the commit history and reshape it into atomic Conventional Commits. See Commits.
- Write the body to a temporary file. Push the branch. Create the PR with
gh pr create --title ... --body-file ...(add--attachfor each screenshot). Use--draftwhen checks are still running or the work is not review-ready. - Open the created PR and verify title, base, head, rendered tables, diagrams, and images.
- Address review comments: fix each confirmed issue, run focused checks, push, reply with evidence, and resolve the thread.