pr-creator

Automates GitHub pull request creation with branch guards, test execution, and commit-based metadata.

1|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/tkogut/agents-os-core --skill pr-creator-tkogut
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-creator
Source: https://github.com/tkogut/agents-os-core/tree/main/global_skills/pr-creator
Command: npx skills add https://github.com/tkogut/agents-os-core --skill pr-creator-tkogut

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Creating pull requests manually involves repetitive steps: verifying you are not on the main branch, running the test suite, writing a title and description, and invoking GitHub CLI. This Skill automates that entire workflow so a PR is only submitted after quality checks pass. ## Core Features & Use Cases - Branch Guard: Blocks PR creation when the agent is on main or master, enforcing feature-branch workflows. - Quality Gate: Auto-detects the project type (Node.js via package.json or Python via pytest) and runs tests before submission, aborting on failure. - Auto Metadata: Generates the PR title and body from the commit history on the current branch relative to origin/main or origin/master. - Use Case: After finishing a feature branch, run the helper script to execute tests, generate a PR description from your commits, and open the pull request through GitHub CLI in one step. ## Quick Start Ask the agent to create a pull request for the current feature branch using the pr-creator helper script.

Frequently Asked Questions about pr-creator

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 command gh pr create with a title and body. The pr_helper.py script automates this by running tests first, generating metadata from your branch commits, and then invoking gh pr create.

How to run tests automatically before creating a pull request?▼

The pr_helper.py script detects your project type and runs npm test for Node.js projects or pytest for Python projects before creating the PR. If tests fail, the script aborts so broken code is never submitted.

Can I create a pull request directly from the main branch?▼

No. The script includes a branch guard that blocks execution on main or master, since pull requests must originate from a feature branch. Switch to a working branch before running the helper.

How do I skip tests or set a custom PR title with pr_helper.py?▼

Pass --skip-tests to bypass the quality gate, or use --title and --body to override the auto-generated metadata. Without these flags, the title and description are built from commits on the current branch.

What happens if GitHub CLI is not installed or configured?▼

The gh pr create step will fail. In that case, follow the manual fallback: run your tests, confirm you are on a feature branch with git branch --show-current, and create the PR through the GitHub web interface.