# Create Pr

> Creates a pull request from the current feature branch with a structured summary, test results, and change description.

- Skill: `guild-agents/create-pr` (Agent Skill)
- Install (CLI): `npx skillmds@latest add guild-agents/create-pr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/guild-agents/create-pr/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools, Code Review
- Tags: Branch, Gh Cli, Git, Github, Pull Request
- Author: Guild-Agents (https://skillmd.com/u/guild-agents)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/guild-agents/create-pr

---


# 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

1. Confirm you are NOT on `main` or `develop` -- refuse to create PR from default branches
2. Run `git status` to check for uncommitted changes -- if any, warn the user and ask whether to commit first
3. Run `git log main..HEAD --oneline` to get the list of commits that will be in the PR
4. 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:

1. **Commits**: `git log main..HEAD --oneline` -- list of all commits on this branch
2. **Diff summary**: `git diff main..HEAD --stat` -- files changed with line counts
3. **Test results**: Run project tests (e.g., `npm test`) and capture pass/fail
4. **Lint results**: Run project lint (e.g., `npm run lint`) and capture pass/fail
5. **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:

```markdown
## 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

1. Push the branch to origin: `git push -u origin [branch-name]`
2. 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)
3. Report the PR URL to the user

### Step 5 -- Post-creation

1. Display the PR URL
2. Suggest next steps:
   - "Request review from a teammate"
   - "Run `/code-review` for an AI code review"
   - "Merge when ready with `gh pr merge [number]`"

## Example Session

```text
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