# Draft Pr

> Generate a PR title and description from your changes

- Skill: `arklexai/draft-pr` (Agent Skill)
- Install (CLI): `npx skillmds@latest add arklexai/draft-pr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/arklexai/draft-pr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: arklexai (https://skillmd.com/u/arklexai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/arklexai/draft-pr

---


# Draft PR

Analyze commits and diff to produce a ready-to-use PR title and description.

## Steps

1. **Analyze commits and diff**
   ```bash
   git log --oneline main..HEAD
   git diff --stat main..HEAD
   git diff main..HEAD
   ```

2. **Determine type and scope**
   - Infer type from changes (feat, fix, docs, chore, etc.)
   - Infer scope from primary directory affected
   - If multiple areas changed equally, omit scope

3. **Validate title**
   - Must match: `^(feat|fix|docs|chore|ci|build|refactor|test|perf|style|revert)(\([a-z][a-z0-9_-]*\))?!?: .+$`
   - Max 72 characters
   - Use imperative mood, lowercase after colon

4. **Read and fill the PR template**

   Read `.github/pull_request_template.md` and fill in each section with real content from the commits and diff. Strip all HTML comments and placeholder text.

5. **Validate description**
   - Ensure at least 20 characters of real content (excluding template boilerplate)

## Output

Print the title and filled PR template body in raw markdown format, ready to copy:

```
Title: <type>(<scope>): <description>

<filled-out PR template in raw markdown>
```