create-pr

Creates GitHub pull requests with branch validation, local checks, and conventional commit titles.

1|Updated Jul 16, 2026
One-click install
npx skills add https://github.com/ConductionNL/buildiq --skill create-pr-conductionnl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-pr
Source: https://github.com/ConductionNL/buildiq/tree/main/.claude/skills/create-pr
Command: npx skills add https://github.com/ConductionNL/buildiq --skill create-pr-conductionnl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Creating a pull request involves many error-prone manual steps: picking the right target branch, checking for existing PRs, running local quality checks, handling uncommitted changes, and drafting a title and description that follow repo conventions. This Skill automates that entire flow so PRs are created correctly the first time. ## Core Features & Use Cases - Branch strategy enforcement: Recommends the correct target branch based on your branching model (feature → development → beta → main) and validates branch-protection rules, including bootstrap deadlock detection for required status checks. - Pre-flight validation: Detects existing PRs, uncommitted changes, unpushed commits, missing lock files, and stale branches (warning when the target is more than 20 commits ahead) before anything is created. - Local CI checks: Mirrors what CI will run (composer check:strict, npm lint, ShellCheck) and blocks PR creation on failures. - Convention-aware drafting: Detects the repo's merged-PR title convention and drafts a Conventional Commits title plus a structured description with a plain-bullet test plan, then creates or updates the PR via the GitHub REST API. - Use Case: You finish a feature branch in a Nextcloud app repo and run the skill; it recommends targeting development, runs the local checks, drafts a compliant title and body, and opens the PR on GitHub. ## Quick Start Ask the assistant to create a pull request from your current branch and it will guide you through target selection, checks, and drafting before opening the PR on GitHub.

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 pull request from the command line?▼

Use the GitHub REST API via gh api repos/{owner}/{repo}/pulls with a POST request containing title, head branch, base branch, and body. This skill automates the full flow including branch detection, target selection, and description drafting.

How to choose the right target branch for a pull request?▼

Follow the repo's branching strategy: feature and bugfix branches target development, development targets beta, beta targets main, and hotfixes target main. The skill recommends the target automatically based on your source branch pattern.

Does this skill work with branch protection rules?▼

Yes, it validates the target branch against branch-protection workflows and detects bootstrap deadlocks where required status checks have no matching CI job. It reports mismatches instead of modifying workflow files, which it never edits.

Why does my PR fail the task-list-completed check?▼

The org-wide task-list-completed check fails when the PR body contains unchecked - [ ] boxes. This skill avoids the issue by always writing the test plan as plain bullet points instead of checkboxes.

What happens if a pull request already exists for my branch?▼

The skill checks for existing open and merged PRs for the same source and target branches before creating anything. You can view the existing PR, update it with new commits and a revised description, or create a duplicate.

Can I create a PR when my branch is far behind the target?▼

Yes, but the skill warns when the target branch is more than 20 commits ahead, since the diff would misleadingly include those commits as deletions. It offers to merge, rebase, or continue anyway before drafting.