What problem does it solve?
This Skill prevents failed or risky pull request creation by guiding a reliable, fork-based PR workflow that handles auth differences, fork setup, default-branch detection, and draft PR creation.
Core Features & Use Cases
- Draft PR creation with guardrails: Always creates a draft PR and targets the repository default branch detected from upstream.
- Auth-aware flow: Detects whether you’re using user auth, GitHub App auth, or no auth and follows the appropriate strategy.
- Fork-first, cross-repo correctness: Ensures a fork exists, configures the correct fork remote, and pushes to the fork (never directly to upstream).
- Workflow-file sync protection: Detects when the fork is out of sync (especially
.github/workflows/ differences) and attempts to sync to avoid permissions errors.
- Failure-resistant fallback: When
gh pr create fails (common for GitHub Apps), provides a pre-filled GitHub compare URL for manual draft completion.
Quick Start
Tell the Skill to open a draft pull request for the changes currently in your working directory by running: /pr