create-draft-pr — skill for Claude Code: commit, push, draft PR
create-draft-pr is a Claude Code skill that commits changes, pushes a branch, and creates a draft PR with a structured description and optional UX context.
no license 107 installs ★ 107 updated 2026-10-05
npx skills add jnsahaj/skills --skill create-draft-pr -a claude-codeWhat create-draft-pr does
The skill runs the complete PR cycle in one action. It checks staged changes via git status and git diff, examines commit history style, creates a branch (if you're on main) following the project convention, commits and pushes with the -u flag, then generates a PR description using the pr-description format. When the change affects user-facing behaviour, workflow, or architecture, it includes a concise UX Flow section.
The description is structured: a one-line summary, a Problem section with specifics, a Solution section with approach and code where relevant. UX Flow appears only for product-oriented or architectural changes—mechanical fixes or dependency bumps skip it. The skill uses HEREDOC to preserve formatting and creates a draft PR via gh pr create --draft.
After PR creation, it switches back to main if that's where you started. PR titles stay concise (no "feat:" prefix, but "fix:" is fine for bug fixes). The description omits test checklists, file-by-file summaries, or attribution footers.
What it helps with
- automate commit, push, and PR creation in one step
- standardize PR description format across the team
- include UX context for changes affecting user workflows
- create a draft PR without merging to the main branch
- follow the project's branch naming convention automatically
Example prompts for the agent
- Create a draft PR for this change explaining the architecture shift
- Commit, push, and open a draft PR with the generated description
- Make a PR with UX flow for the new signup flow
How to install create-draft-pr
1Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill create-draft-pr -a claude-code2Manually: put the files in place
~/.claude/skills/create-draft-pr/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/create-draft-pr/
1Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill create-draft-pr -a codex2Manually: put the files in place
.agents/skills/create-draft-pr/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill create-draft-pr -a cursor2Manually: put the files in place
.cursor/skills/create-draft-pr/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jnsahaj/skills skills/create-draft-pr2Manually: put the files in place
.github/skills/create-draft-pr/SKILL.md1Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill create-draft-pr -a gemini-cli2Platform CLI
gemini skills install https://github.com/jnsahaj/skills --path skills/create-draft-prManually: put the files in place
.devin/skills/create-draft-pr/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill create-draft-pr -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about create-draft-pr
How do I install create-draft-pr in Claude Code?
Run npx skills add jnsahaj/skills --skill create-draft-pr -a claude-code, then open ~/.claude/skills/create-draft-pr/SKILL.md to confirm the skill is loaded.
What does create-draft-pr do?
The skill commits all staged changes, pushes the branch to the remote, and creates a draft PR with an auto-generated description following a standard format. It optionally includes a UX Flow section for user-facing or architectural changes.
Does the UX Flow section always appear?
No. UX Flow is added only for changes affecting user experience, workflows, or architecture. Internal refactors, dependency updates, or minor fixes omit it.