Guild-Agents/guild / .claude/skills/create-pr
create-pr
VerifiedCreate a pull request from the current branch with structured summary
Create PR
Creates a pull request from the current feature branch with a structured summary, test results, and change description. Closes the pipeline loop: init -> build-feature -> create-pr.
When to use
- After completing a feature with
/build-feature - When you have changes on a feature branch ready for review
- To create a well-structured PR without manual formatting
Usage
/create-pr
Process
Step 1 -- Verify branch state
- Confirm you are NOT on
mainordevelop-- refuse to create PR from default branches - Run
git statusto check for uncommitted changes -- if any, warn the user and ask whether to commit first - Run
git log main..HEAD --onelineto get the list of commits that will be in the PR - If there are no commits ahead of main, report that there is nothing to PR
Step 2 -- Gather context
Collect the information needed for the PR description:
- Commits:
git log main..HEAD --oneline-- list of all commits on this branch - Diff summary:
git diff main..HEAD --stat-- files changed with line counts - Test results: Run project tests (e.g.,
npm test) and capture pass/fail - Lint results: Run project lint (e.g.,
npm run lint) and capture pass/fail - Branch name: Extract feature name from the branch (e.g.,
feature/dark-mode->dark-mode)
If tests or lint fail, warn the user but allow them to proceed (some PRs are draft/WIP).
Step 3 -- Generate PR description
Build a structured PR description:
## Summary
[2-4 bullet points describing what this PR does, derived from commit messages]
## Changes
[File-level summary from git diff --stat]
## Test plan
- [x] Tests: [pass/fail] ([count] tests)
- [x] Lint: [pass/fail]
- [ ] [Any manual verification steps if applicable]
Step 4 -- Create the PR
- Push the branch to origin:
git push -u origin [branch-name] - Create the PR using
gh pr create:- Title: derived from branch name or first commit message (max 70 chars)
- Body: the generated description from Step 3
- Base:
main(or the project's default branch)
- Report the PR URL to the user
Step 5 -- Post-creation
- Display the PR URL
- Suggest next steps:
- "Request review from a teammate"
- "Run
/code-reviewfor an AI code review" - "Merge when ready with
gh pr merge [number]"
Example Session
User: /create-pr
Checking branch state...
Branch: feature/dark-mode (4 commits ahead of main)
Tests: 82 passed, 0 failed
Lint: 0 errors
Creating PR...
PR #42: "feat: add dark mode toggle to settings"
https://github.com/org/repo/pull/42
Next steps:
- Request review from a teammate
- Run /code-review for AI code review
- Merge when ready
Notes
- The PR title should be concise (under 70 characters) and follow conventional commits format when the project uses it
- If the branch has
wip:commits from build-feature checkpoints, consider squashing them before creating the PR - This skill does NOT merge the PR -- that is a manual step or a separate command
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |