Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jnsahaj/skills --skill create-draft-pr -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/create-draft-pr/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/create-draft-pr/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set6

Project sponsors

Companies that keep this analytics open