open-pr

Drafts a pull request for the current branch using the repository PR template.

15|22|Updated May 5, 2024
One-click install
npx skills add https://github.com/brayandiazc/project-starter-template-es-ai --skill open-pr-brayandiazc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: open-pr
Source: https://github.com/brayandiazc/project-starter-template-es-ai/tree/main/.claude/skills/open-pr
Command: npx skills add https://github.com/brayandiazc/project-starter-template-es-ai --skill open-pr-brayandiazc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a complete pull request description requires reviewing every commit and diff on a branch, then mapping that work into the repository's PR template. This Skill automates that drafting process while enforcing pre-merge quality gates so no PR opens with failing checks or outdated documentation. ## Core Features & Use Cases - Template-driven drafting: Reads .github/PULL_REQUEST_TEMPLATE.md and fills each section (summary, linked issues, test notes, checklist) from the branch's commits and diffs. - Pre-flight quality gates: Runs the doc-keeper subagent to sync docs, diagrams, ADRs, and CHANGELOG, plus the pre-push hook replicating CI checks before opening the PR. - GitHub CLI integration: Creates the PR via gh pr create when the branch is pushed, or outputs the filled template for manual submission. - Use Case: After finishing a feature branch, ask for a PR and receive a fully drafted description with verified checks, ready to submit or review. ## Quick Start Ask the assistant to open a pull request for the current branch and it will gather the commits, run the checks, and draft the PR body from the repository template.

Frequently Asked Questions about open-pr

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

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

Use the GitHub CLI with `gh pr create --title ... --body ...` after pushing your branch. This Skill automates that step by gathering commit history and diffs, then filling the repository's PR template before running the command.

How to auto-fill a GitHub pull request template?▼

The Skill reads `.github/PULL_REQUEST_TEMPLATE.md`, collects context via `git log` and `git diff` against the base branch, and fills each section including summary, linked issues, and test notes. Checklist items are only marked when actually completed.

Can this Skill merge or approve pull requests?▼

No. The Skill explicitly does not merge, approve, or check off unverified checklist items. It only drafts and creates the PR, and opens it as a draft when the work is incomplete.

What happens if CI checks fail before opening a PR?▼

The Skill runs the repository's `pre-push` hook, which replicates the CI checks locally. If anything fails, it stops and reports the problem instead of opening the PR, so a red PR is never created.

Does the PR workflow update documentation automatically?▼

Yes. Before drafting, it runs a doc-keeper subagent over the diff to sync architecture docs, diagrams, ADRs, the CHANGELOG entry, and the relevant roadmap item declared in the spec.