create-pr

Creates GitHub pull requests with conventional commit titles, labels, and structured descriptions.

Updated May 23, 2026
One-click install
npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill create-pr-kiranimmadi2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-pr
Source: https://github.com/kiranimmadi2/promptforge-ai/tree/main/ai_clients_dart/.agents/skills/create-pr
Command: npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill create-pr-kiranimmadi2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually creating pull requests in a monorepo involves analyzing changes across packages, writing conventional commit messages, generating branch names, applying the right labels, and formatting descriptions — a repetitive, error-prone process. This Skill automates the entire PR creation workflow for the ai_clients_dart monorepo. ## Core Features & Use Cases - Automated change analysis: Inspects uncommitted changes and existing commits, categorizes them by package, and plans conventional commits grouped by type and scope. - Structured PR generation: Produces conventional commit titles under 70 characters and descriptions with Summary, Details, Breaking Changes, References, and Test Plan sections that feed changelog generation. - Label and assignee mapping: Maps changed package directories to p: labels, commit types to t: labels, and resolves assignees from CODEOWNERS. - Use Case: After implementing a new streaming feature in openai_dart and fixing a bug in chromadb, ask the assistant to create a PR — it commits the changes with proper conventional messages, pushes a branch, and opens a labeled PR via gh. ## Quick Start Ask the assistant to create a pull request for your current changes, optionally passing --draft or --base to target a different branch.

Frequently Asked Questions about create-pr

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

FAQPage Schema
How do I create a GitHub pull request from the command line?

Use the GitHub CLI with gh pr create, passing a title, body, labels, assignee, and base branch. This Skill automates that flow by analyzing your changes, generating conventional commit titles, and pushing the branch before opening the PR.

How to write conventional commit messages for a monorepo?

Use the format type(scope): description, where the scope is the package name like openai_dart or chromadb. Group changes into separate commits per package and type, and mark breaking changes with an exclamation mark or a BREAKING CHANGE footer.

Can I create a draft pull request or target a different base branch?

Yes. Pass --draft to open the PR as a draft, or --base <branch> to target a branch other than main. The Skill verifies the base branch exists and fetches it from origin if needed.

What happens if a pre-commit hook fails during PR creation?

The Skill diagnoses the failure, fixes the issue such as running dart format, re-stages the affected files, and creates a new commit rather than amending. If the hook modifies files after succeeding, those changes get an additional commit.

Does this work if a pull request already exists on my branch?

Yes. The Skill detects an existing open PR on the current branch via gh pr view, pushes the new commits, and updates the title, body, and labels with gh pr edit instead of creating a duplicate.