Agent skill

PR

by PX4 in PX4/PX4-Autopilot

Create a pull request with conventional commit title and description

BSD-3-ClauseAuto-check: notesDevelopment

Install PR

skills CLI
$ npx skills add PX4/PX4-Autopilot --skill pr -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install PX4/PX4-Autopilot pr --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/PX4/PX4-Autopilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/pr .claude/skills/pr && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pr
GitHub stars
13k
Token cost
~581 tokens
SKILL.md length
320 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

Create a pull request with conventional commit title and description

  • Works in 8 steps: Check branch. If on main, create a… → Gather context: git status, git log… → Sanity-build one target the change can… → …
  • Tasks that involve Pull requests
  • Calls git and gh
  • Tasks that involve Commit messages

What it does

PR is an agent skill from PX4/PX4-Autopilot. Create a pull request with conventional commit title and description

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Pull requests and Commit messages. It works with Git. The repository describes itself as: PX4 Autopilot Software. The licence is BSD-3-Clause.

When your agent uses it

  • Tasks that involve Pull requests
  • Tasks that involve Commit messages

Example prompts

  • “/pr”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Glob, Grep

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Check branch. If on main, create a feature branch /
  2. Gather context: git status, git log --oneline main..HEAD,
  3. Sanity-build one target the change can actually affect — a board for
  4. PR title: type(scope): description — under 72 chars, covers the
  5. PR body: as short as it can be while still landing the point — a
  6. Optional ## Testing section after ## Solution, only for substantial
  7. Push with -u if needed, then gh pr create. Default base is main
  8. Return the PR URL.

What it can do on your machine

Read from SKILL.md and the folder at commit df387bd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

PR loads about 581 tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 320 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~18
When it runs · the whole SKILL.md, loaded when a task matches
~581

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Glob, Grep

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from PX4/PX4-Autopilot at commit df387bd, republished under its BSD-3-Clause licence (© PX4). 320 words, ~581 tokens.

Download SKILL.mdSave it as .claude/skills/pr/SKILL.md (or your agent's skills folder).
name
pr
description
Create a pull request with conventional commit title and description
allowed-tools
Bash, Read, Glob, Grep
argument-hint
[optional: target branch or description]

PX4 Pull Request

The user is the author: no Co-Authored-By, no "Generated with <assistant>" footers. Disclose AI assistance as the last line of the PR body, italicized: *Assisted-by: <tool>:<model-id>*, matching the commit trailer.

Steps

  1. Check branch. If on main, create a feature branch <username>/<description> where <username> comes from gh api user --jq .login.
  2. Gather context: git status, git log --oneline main..HEAD, git diff main...HEAD --stat, check for remote tracking branch.
  3. Sanity-build one target the change can actually affect — a board for firmware changes, px4_sitl for POSIX-only or simulation changes. Skip the build entirely when the diff cannot reach any target (submodule pointer bumps, docs, ROMFS). Build with the build-px4-linux or build-px4-macos skill. Fix any build errors before opening the PR.
  4. PR title: type(scope): description — under 72 chars, covers the overall change across all commits. If a maintainer squash-merges the PR, this becomes the commit message.
  5. PR body: as short as it can be while still landing the point — a reviewer should take it in at a glance, and a long description is one nobody reads. Sections, in order: ## Summary, ## Problem, ## Solution, a sentence or two each. Do not restate the diff (no file-changed lists, no code snippets), do not mention CI, and do not repeat what the title already says. If the PR closes an issue, the first line of ## Summary is fixes #<N>, then a blank line, then the summary. No boilerplate.
  6. Optional ## Testing section after ## Solution, only for substantial testing: SITL scenarios, synthetic or replayed data, hardware-in-the-loop, bench or flight tests. Building and unit tests are not testing; never mention them. State what was run and what it showed, as tersely as the other sections. Never report testing that did not happen: ask the user what they actually ran.
  7. Push with -u if needed, then gh pr create. Default base is main unless user says otherwise.
  8. Return the PR URL.

© PX4, BSD-3-Clause. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/pr of PX4/PX4-Autopilot.

Open the folder on GitHubat commit df387bd

Compare with similar skills

PR next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PR this skillPX4/PX4-Autopilot13k—~581Automated safety check: NotesBSD-3-Clause
Git Workflow and Versioningaddyosmani/agent-skills103k2 repos~3.5kAutomated safety check: NotesMIT
React Router Pull Request Creatorremix-run/react-router57k—~2.5kAutomated safety check: PassMIT
Verdaccio Pull Request Workflowverdaccio/verdaccio18k—~1.9kAutomated safety check: PassMIT
Emoji Commit ConventionsbaptisteArno/typebot.io11k—~424Automated safety check: PassCustom licence
Draft Pull Request Creatorwordpress-mobile/WordPress-Android3.2k—~881Automated safety check: NotesGPL-2.0

Similar skills

  • Git Workflow and Versioning

    addyosmani/agent-skills

    Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.

    103k GitHub starsUsed in 2 repos~3.5k tokens
    DevelopmentAuto-check: notes
  • React Router Pull Request Creator

    remix-run/react-router

    Packages finished React Router work into a draft pull request: branch, commit, push, a written PR body and the right GitHub labels.

    57k GitHub stars~2.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Emoji Commit Conventions

    baptisteArno/typebot.io

    Sets the repository's convention for commit messages and pull request titles: one emoji prefix for the main intent, a concise title and clean follow-up commits.

    11k GitHub stars~424 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Draft Pull Request Creator

    wordpress-mobile/WordPress-Android

    Commits and pushes current changes, writes a pull request title and body from the branch history and template, and opens a draft PR on GitHub after you approve it.

    3.2k GitHub stars~881 tokensUpdated today
    DevelopmentAuto-check: notes
  • Submit PR

    tisfeng/Easydict

    创建或复用当前 checkout 已提交变更的 GitHub PR,必要时推送任务分支。PR 审查使用 review-pr;仅本地提交使用 git-commit。

    15k GitHub stars~595 tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from PX4/PX4-Autopilot

  • Build Px4 macOS

    PX4/PX4-Autopilot

    Build PX4 board firmware on macOS in the px4-dev Docker container, including git worktrees, and stage commit-labeled artifacts without flashing hardware.

    13k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Rebase Onto Main

    PX4/PX4-Autopilot

    Rebase a branch onto main, handling squash-merged parent branches cleanly

    13k GitHub stars~1.1k tokensUpdated today
    Auto-check: notes
  • Build Px4 Linux

    PX4/PX4-Autopilot

    Build PX4 firmware or SITL natively on a Linux host, in the current checkout, without flashing hardware.

    13k GitHub stars~385 tokensUpdated today
    Auto-check passed
  • Review PR

    PX4/PX4-Autopilot

    Substance-focused review of a PX4 pull request — merit, first-principles correctness, architecture fit.

    13k GitHub stars~1k tokensUpdated today
    Auto-check: notes
  • Commit

    PX4/PX4-Autopilot

    Create a conventional commit for PX4 changes. An agent skill from PX4/PX4-Autopilot.

    13k GitHub stars~527 tokensUpdated today
    Auto-check: notes

Works with

Categories

Questions about PR

What does PR do?

Create a pull request with conventional commit title and description. PR is an agent skill from PX4/PX4-Autopilot.

When should I use PR?

PR fits situations like: tasks that involve Pull requests; tasks that involve Commit messages.

How do I install PR in Claude Code?

Run `npx skills add PX4/PX4-Autopilot --skill pr -a claude-code`. Or copy the skill folder (.agents/skills/pr in PX4/PX4-Autopilot) into .claude/skills/pr in your project. Claude Code loads it when a task matches its description.

How do I install PR in Codex?

Run `npx skills add PX4/PX4-Autopilot --skill pr -a codex`. Or copy the skill folder (.agents/skills/pr in PX4/PX4-Autopilot) into .agents/skills/pr in your project. Codex loads it when a task matches its description.

Can I use PR in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add PX4/PX4-Autopilot --skill pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pr, .gemini/skills/pr, .github/skills/pr and .opencode/skills/pr in your project.

What does PR need to run?

Going by SKILL.md and its folder, PR needs the command-line tools its instructions call (git and gh). Its frontmatter pre-approves these tools: Bash, Read, Glob, Grep.

Does PR access the network?

SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is PR safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does PR use?

PR is published under the BSD-3-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does PR use?

About 581 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to PR?

Skills that share tags, products or a category with PR: Git Workflow and Versioning (addyosmani/agent-skills, 103k stars), React Router Pull Request Creator (remix-run/react-router, 57k stars), Verdaccio Pull Request Workflow (verdaccio/verdaccio, 18k stars) and Emoji Commit Conventions (baptisteArno/typebot.io, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PR?

PX4 (a GitHub organization) maintains it in PX4/PX4-Autopilot, which has 12,756 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 7, 2026.

Source: PX4/PX4-Autopilot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.