# Pr

> Creates a draft GitHub pull request with a plain-text conventional-commit title and a succinct description of the branch. Use when the user asks to open, raise, or create a pull request or PR.

- **Type:** Skill
- **Install:** `agentstack add skill-rikdc-ai-skills-pr`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [rikdc](https://agentstack.voostack.com/s/rikdc)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MPL-2.0
- **Upstream author:** [rikdc](https://github.com/rikdc)
- **Source:** https://github.com/rikdc/ai-skills/tree/main/plugins/git-workflow/skills/pr

## Install

```sh
agentstack add skill-rikdc-ai-skills-pr
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# PR - GitHub Pull Request Creation

Creates a draft pull request with a conventional-commit title and a short
description of what the branch actually changes.

## Workflow

1. **Validate**: `gh auth status`, current branch, uncommitted changes.
2. **Read the branch**: `git log ..HEAD` and `git diff ...HEAD` —
   the description covers exactly this, nothing more.
3. **Write the body**: use `.github/pull_request_template.md` if present,
   otherwise the sections below.
4. **Create**: `gh pr create --draft --title "(): " --body-file  --base main`

## Title Rules

- Conventional commit format: `(): `.
- **No emoji.** The title is plain text.
- Under 70 characters, imperative mood, no trailing period.
- For a single-commit PR, reuse that commit's subject.

Examples:

- `feat(auth): add session refresh endpoint`
- `fix(scanner): match patterns case-insensitively`
- `docs: document the scanner exit codes`

## Body Rules

Keep it succinct. The PR body describes the commits on the branch and nothing
else.

- **Summary**: one to three sentences. What changed and why. No restating the
  title, no background essay.
- **Changes**: one bullet per meaningful change, one line each. Group trivial
  edits rather than listing every file. Under six bullets for a normal PR — if
  it needs more, the PR is probably too large.
- **Testing**: one line stating what was run (`make test`, `go test ./...`) and
  the result. Say so plainly if nothing was run.
- Drop any template section that has nothing real to say.
- No emoji, no headings beyond the template's, no "Notes for reviewers",
  "Future work", "Impact", or risk-assessment sections unless asked.
- Do not claim behaviour you have not verified.

Default body when there is no template:

```markdown
## Summary

## Changes

- 
- 

## Testing

```

Example body:

```markdown
## Summary

Pattern matching in the MCP scanner was case-sensitive, so uppercase AWS keys
passed the scan. Matching is now case-insensitive.

## Changes

- Add `-i` to the pattern grep in `mcp-security-scanner.sh`
- Cover uppercase keys in `tests/test-scanner.sh`

## Testing

`make test` — all suites pass.
```

## Common Actions

```bash
gh pr ready                                     # draft to ready
gh pr edit  --add-reviewer user1,user2          # add reviewers
gh pr status                                               # check status
```

## Error Handling

- Missing `gh`: prompt to install.
- Not authenticated: run `gh auth status` and prompt to log in.
- Missing PR template: use the default body above; do not create the template
  file unless asked.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [rikdc](https://github.com/rikdc)
- **Source:** [rikdc/ai-skills](https://github.com/rikdc/ai-skills)
- **License:** MPL-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-rikdc-ai-skills-pr
- Seller: https://agentstack.voostack.com/s/rikdc
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.