create-pr

Group uncommitted changes into Conventional Commits and open a pull request.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/neon-law-foundation/navigator --skill create-pr-neon-law-foundation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-pr
Source: https://github.com/neon-law-foundation/navigator/tree/main/.claude/skills/create-pr
Command: npx skills add https://github.com/neon-law-foundation/navigator --skill create-pr-neon-law-foundation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns a messy working tree into a clean, reviewable pull request against main, so you can move from local edits to an auto-mergeable PR without manually sorting commits, branching, and GitHub setup.

Core Features & Use Cases

  • Change Survey and Grouping: Reads staged, unstaged, and untracked files, then groups them into the smallest coherent Conventional Commit units.
  • Workspace Gatekeeping: Runs formatting, linting, testing, and markdown checks before the first commit to avoid opening a broken PR.
  • Branch, Push, and PR Automation: Creates or reuses a topic branch, commits each group in order, pushes to origin, opens a pull request, and enables auto-merge.
  • Use Case: A developer with a dirty repository and several unrelated edits can use this Skill to ship them as a polished PR with a clear commit history and a verified test plan.

Quick Start

Use the create-pr skill to group my current changes into conventional commits, open a pull request against main, and enable auto-merge.

Frequently Asked Questions about create-pr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn dirty working-tree changes into a pull request with conventional commits?

To turn dirty working-tree changes into a pull request, this Skill groups uncommitted files into coherent Conventional Commit units, creates a topic branch, pushes the commits, and opens a PR against main.

Can I automatically enable auto-merge when creating a GitHub pull request from local edits?

Yes, you can automatically enable auto-merge when creating a GitHub pull request. After grouping changes into commits and pushing to origin, the Skill opens the pull request and enables the auto-merge feature.

How do I group uncommitted files into conventional commit units before pushing a branch?

You group uncommitted files into conventional commit units by surveying staged, unstaged, and untracked changes, then sorting them into the smallest coherent logical groups for individual commits.

Does this pull request automation run formatting and tests before making the first commit?

Yes, this pull request automation runs formatting and tests before the first commit. It applies workspace validation including linting, testing, and markdown checks to ensure you avoid opening a broken PR.

What is the best way to automate branching and PR creation from a dirty repository?

The best way to automate branching from a dirty repository is using a workflow that reads uncommitted changes, creates or reuses a topic branch, commits grouped units in order, and pushes to origin.

When should I not use an automated tool to group local edits into a pull request?

You should not use an automated tool to group local edits when your working tree contains changes that require complex manual staging or custom commit message formatting outside the Conventional Commits standard.