
Create Pr
Open GitHub pull requests from an agent session with n8n-compliant conventional titles that pass check-pr-title CI.
Overview
create-pr is an agent skill for the Ship phase that creates GitHub pull requests with conventional titles formatted to pass n8n check-pr-title CI.
Install
npx skills add https://github.com/n8n-io/n8n --skill create-prWhat is this skill?
- Enforces `<type>(<scope>): <summary>` titles required by n8n `check-pr-title` CI
- Maps 9 commit types (feat, fix, perf, test, docs, refactor, build, ci, chore) with changelog eligibility
- Documents recommended scopes such as API, core, and benchmark for monorepo PRs
- Triggered by `/pr`, “create a pull request”, or submitting changes for review
- Uses git and GitHub CLI (`gh`) with read/grep/glob to draft accurate summaries
- Documents 9 PR title types with explicit changelog yes/no mapping
- Requires titles in the form `<type>(<scope>): <summary>` for check-pr-title CI
Adoption & trust: 855 installs on skills.sh; 192k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your branch is ready but a malformed PR title will fail CI and block review.
Who is it for?
n8n contributors or forks mirroring n8n CI rules who want agent-assisted PR creation from the terminal.
Skip if: Repositories without conventional-commit PR title checks, or changes that are not yet committed on a pushed branch.
When should I use this skill?
Creating PRs, submitting changes for review, when the user says `/pr`, or asks to create a pull request.
What do I get? / Deliverables
You get a GitHub PR opened via `gh` with a validated `<type>(<scope>): <summary>` title ready for reviewer assignment.
- Opened GitHub pull request with CI-compliant title
- Correct type and scope selection aligned to n8n changelog rules
Recommended Skills
Journey fit
How it compares
Git PR workflow skill with n8n-specific title rules, not a full code-review or testing skill.
Common Questions / FAQ
Who is create-pr for?
Developers submitting changes to n8n (or similar CI-gated repos) who want agents to format PR titles and open reviews correctly.
When should I use create-pr?
At Ship/review when commits are done and you need a GitHub PR that passes `check-pr-title`, including when you say `/pr` or ask to create a pull request.
Is create-pr safe to install?
Review the Security Audits panel on this page; the skill uses git and `gh`, so confirm branch targets and repo remotes before the agent pushes or opens PRs.
SKILL.md
READMESKILL.md - Create Pr
# Create Pull Request Creates GitHub PRs with titles that pass n8n's `check-pr-title` CI validation. ## PR Title Format ``` <type>(<scope>): <summary> ``` ### Types (required) | Type | Description | Changelog | |------------|--------------------------------------------------|-----------| | `feat` | New feature | Yes | | `fix` | Bug fix | Yes | | `perf` | Performance improvement | Yes | | `test` | Adding/correcting tests | No | | `docs` | Documentation only | No | | `refactor` | Code change (no bug fix or feature) | No | | `build` | Build system or dependencies | No | | `ci` | CI configuration | No | | `chore` | Routine tasks, maintenance | No | ### Scopes (optional but recommended) - `API` - Public API changes - `benchmark` - Benchmark CLI changes - `core` - Core/backend/private API - `editor` - Editor UI changes - `* Node` - Specific node (e.g., `Slack Node`, `GitHub Node`) ### Summary Rules - Use imperative present tense: "Add" not "Added" - Capitalize first letter - No period at the end - No ticket IDs (e.g., N8N-1234) - Add `(no-changelog)` suffix to exclude from changelog ## Steps 1. **Check current state**: ```bash git status git diff --stat git log origin/master..HEAD --oneline ``` 2. **Check for implementation plan**: Look for a plan file in `.claude/plans/` that matches the current branch's ticket ID (e.g. if branch is `scdekov/PAY-1234-some-feature`, check for `.claude/plans/PAY-1234.md`). If a plan file exists, ask the user whether they want to include it in the PR description as a collapsible `<details>` section (see Plan Section below). Only include the plan if the user explicitly approves. 3. **If this is a security fix**, audit every public-facing artifact before proceeding (see Security Fixes below). 4. **Analyze changes** to determine: - Type: What kind of change is this? - Scope: Which package/area is affected? - Summary: What does the change do? 5. **Push branch if needed**: ```bash git push -u origin HEAD ``` 6. **Create PR** using gh CLI with the template from `.github/pull_request_template.md`: ```bash gh pr create --draft --title "<type>(<scope>): <summary>" --body "$(cat <<'EOF' ## Summary <Describe what the PR does and how to test. Photos and videos are recommended.> ## Related Linear tickets, Github issues, and Community forum posts <!-- Link to Linear ticket: https://linear.app/n8n/issue/[TICKET-ID] --> <!-- Use "closes #<issue-number>", "fixes #<issue-number>", or "resolves #<issue-number>" to automatically close issues --> ## Review / Merge checklist - [ ] PR title and summary are descriptive. ([conventions](../blob/master/.github/pull_request_title_conventions.md)) - [ ] [Docs updated](https://github.com/n8n-io/n8n-docs) or follow-up ticket created. - [ ] Tests included. - [ ] PR Labeled with `release/backport` (if the PR is an urgent fix that needs to be backported) EOF )" ``` ## PR Body Guidelines Based on `.github/pull_request_template.md`: ### Summary Section - Describe what the PR does - Explain how to test the changes - Include screenshots/videos for UI changes ### Related Links Section - Link to Linear ticket: `https://linear.app/n8n/issue/[TICKET-ID]` - Link to GitHub issues using keywords