create-pr

Create a pull request with branch setup and automated review loop.

2|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/tim-hub/powerball --skill create-pr-tim-hub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-pr
Source: https://github.com/tim-hub/powerball/tree/main/pbl/skills/create-pr
Command: npx skills add https://github.com/tim-hub/powerball --skill create-pr-tim-hub

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates creating a pull request from your current changes, handling branch setup, PR description formatting, and an automated review loop.

Core Features & Use Cases

  • Branch handling: if on main/master with changes, creates a feature branch (via worktree), commits, and pushes.
  • PR description generation: formats a descriptive PR body using a template and includes a mermaid diagram to illustrate changes.
  • Automated review loop: runs an integrated review toolkit up to three rounds to fix issues automatically.
  • PR creation: uses gh pr create with a concise title and a well-structured body, then reports the PR URL.

Quick Start

Create a pull request from your current changes with an automatic branch setup and review workflow.

Frequently Asked Questions about create-pr

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

FAQPage Schema
How do I automate pull request creation from local git changes on a main branch?

To automate pull request creation from a main branch, the tool detects your uncommitted changes, creates a feature branch via a worktree, commits the changes, and pushes the branch. It then formats the PR description and opens the pull request automatically.

Can I generate a mermaid diagram in a GitHub pull request description automatically?

Yes, you can generate a mermaid diagram in a GitHub pull request description automatically. The automation formats the PR body using a template and includes a mermaid diagram to visually illustrate the changes made in the code.

Does automated code review work with the gh CLI when creating a PR?

Automated code review works with the gh CLI by running an integrated review toolkit up to three rounds after the PR is created. It automatically detects and attempts to fix issues iteratively before finalizing the pull request.

What is the best way to handle branch management when committing changes for a PR?

The best way to handle branch management for a PR is using an automated workflow that detects if you are on main, creates a feature branch via worktree, commits the changes, and pushes the branch before opening the pull request.

Do I need git access and the gh CLI installed to automate PR formatting and review?

Yes, you need git access and the gh CLI installed to automate PR formatting and review. These dependencies are required to detect the base branch, create the PR with a structured body, and perform the iterative automated review loop.