Agent skill

Draft Pull Request Creator

by wordpress-mobile in 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.

GPL-2.0Auto-check: notesDevelopment

Install Draft Pull Request Creator

skills CLI
$ npx skills add wordpress-mobile/WordPress-Android --skill draft-pr -a claude-code

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

GitHub CLI
$ gh skill install wordpress-mobile/WordPress-Android draft-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/wordpress-mobile/WordPress-Android.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/draft-pr .claude/skills/draft-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
draft-pr
GitHub stars
3.2k
Token cost
~881 tokens
SKILL.md length
488 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
GPL-2.0

At a glance

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.

  • Works in 10 steps: Check current branch and changes → Confirm with the user → Commit changes (if needed) → …
  • Opening a draft pull request for the branch you are working on
  • SKILL.md covers Steps and Important Rules
  • Calls git and gh

What it does

The skill runs nine steps. It checks git status, diff and log, summarizes the changes and asks permission before committing or pushing. Files are staged by name rather than with a blanket add, likely secret files such as `.env` are left out with a warning, and the commit message is short and explains why. The branch is pushed with upstream tracking when needed.

To write the PR, the agent finds the base branch, usually `trunk`, reviews every commit since the merge base and reads each changed file in full. The title stays short and is prefixed with a Linear issue identifier in uppercase when the branch name contains one, and the body follows the repository's `.github/PULL_REQUEST_TEMPLATE.md`. The title and body are shown as raw Markdown for your approval, and only then is the draft created with `gh pr create --draft`.

When your agent uses it

  • Opening a draft pull request for the branch you are working on
  • Writing a PR description that follows the repository template
  • Committing and pushing changes without staging secrets by accident

Example prompts

  • “Create a draft PR for my current branch.”
  • “Push what I have and open a draft pull request, but show me the description first.”
  • “Run /draft-pr once the login fix is committed and ready for review.”

Requirements

  • Git with a configured remote
  • GitHub CLI (`gh`)

Workflow steps

10 steps, taken from the step headings in SKILL.md.

  1. Check current branch and changes
  2. Confirm with the user
  3. Commit changes (if needed)
  4. Push to remote
  5. Determine the base branch and gather context
  6. Read changed files for context
  7. Draft the PR title and description
  8. Present the PR for approval
  9. Create the draft PR
  10. Report the result

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    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

Draft Pull Request Creator loads about 881 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 488 words of instructions outside code blocks.

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

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.

  • NoteMentions a .env fileSKILL.md:32
    mmit files that likely contain secrets (`.env`,

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 wordpress-mobile/WordPress-Android at commit ceafcdc, republished under its GPL-2.0 licence (© wordpress-mobile). 488 words, ~881 tokens.

Download SKILL.mdSave it as .claude/skills/draft-pr/SKILL.md (or your agent's skills folder).
name
draft-pr
description
Push current changes and create a draft Pull Request on GitHub. This skill should be used when the user asks to create a PR, draft PR, or invokes /draft-pr.

Draft PR

Push current changes and create a draft Pull Request on GitHub.

Steps

1. Check current branch and changes

Run git status and git diff to understand what is staged, unstaged, and untracked. Run git log to review recent commit messages and the repository's commit message style.

2. Confirm with the user

Before committing or pushing, present a summary of the changes and ask the user for explicit permission to proceed with the commit and push.

3. Commit changes (if needed)

If there are uncommitted changes:

  • Stage relevant files by name (avoid git add -A or git add . to prevent accidentally including secrets or large binaries).
  • Do NOT commit files that likely contain secrets (.env, credentials.json, etc.). Warn the user if they specifically request to commit those files.
  • Write a concise commit message (1-2 sentences) that focuses on the "why" rather than the "what".
  • Use a HEREDOC to pass the commit message to ensure correct formatting.
4. Push to remote

Push the current branch to the remote with the -u flag to set up tracking if needed.

5. Determine the base branch and gather context

Identify the base branch (typically trunk). Run git merge-base to find the common ancestor. Then run:

bash
git log <merge-base>..HEAD --oneline
git diff <merge-base>..HEAD

Review ALL commits on the branch (not just the latest) to understand the full scope of changes.

6. Read changed files for context

For each file changed on the branch, read the full file to understand the surrounding context beyond just the diff hunks.

7. Draft the PR title and description

Follow these rules:

  • Keep the PR title short (under 70 characters). Use the description/body for details.
  • Try to extract a Linear issue identifier from the branch name (e.g., cmm-1234 from feature/cmm-1234-some-description). If found, prefix the PR title with it in uppercase: CMM-1234: Title here. If the branch name does not contain a recognizable Linear identifier, omit the prefix.
  • Read .github/PULL_REQUEST_TEMPLATE.md and follow its structure and formatting instructions for the PR body.
Show full SKILL.md (164 more words)Show less
8. Present the PR for approval

Output the PR title and full description as raw markdown inside a code block so the user can review and copy it. Ask the user to confirm or request changes before creating the PR.

9. Create the draft PR

Once approved, create the PR using gh pr create --draft with a HEREDOC for the body:

bash
gh pr create --draft --title "the pr title" --body "$(cat <<'EOF'
## Description
...

## Testing instructions
...
EOF
)"
10. Report the result

Output the PR URL and, if running in a local GUI environment, attempt to open it in the user's browser.

Important Rules

  • NEVER push or commit without explicit user approval for THAT specific operation.
  • NEVER use destructive git commands (push --force, reset --hard, etc.) unless the user explicitly requests them.
  • NEVER skip hooks (--no-verify) unless the user explicitly requests it.
  • NEVER amend previous commits unless the user explicitly requests it. If a pre-commit hook fails, fix the issue and create a NEW commit.
  • NEVER push to main or trunk directly.
  • Always create the PR as a draft (--draft flag).

© wordpress-mobile, GPL-2.0. 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 .claude/skills/draft-pr of wordpress-mobile/WordPress-Android.

Open the folder on GitHubat commit ceafcdc

Compare with similar skills

Draft Pull Request Creator 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.

Draft Pull Request Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Draft Pull Request Creator this skillwordpress-mobile/WordPress-Android3.2k—~881Automated safety check: NotesGPL-2.0
React Router Pull Request Creatorremix-run/react-router57k—~2.5kAutomated safety check: PassMIT
Publish Pull Request for taskctltaskctl/taskctl434—~979Automated safety check: PassGPL-3.0
Git GitHub Opsc5inco/compose-pokedexer143—~1.3kAutomated safety check: PassMIT
Pull Request Creationlobehub/lobehub83k—~3.2kAutomated safety check: PassCustom licence
Managing Git Workflowhashintel/hash1.7k—~1.2kAutomated safety check: PassAGPL-3.0

Similar skills

  • 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 today
    DevelopmentAuto-check passed
  • Publishes the current branch and opens or updates a GitHub pull request for the taskctl repo, after a pre-publish gate and with a description template matched to the change.

    434 GitHub stars~979 tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Git GitHub Ops

    c5inco/compose-pokedexer

    Handles Pokedexer Git and GitHub workflows: inspect changes, prepare commit messages, manage branches and pushes, and create or update issues and pull requests with safe file-based inputs.

    143 GitHub stars~1.3k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Pull Request Creation

    lobehub/lobehub

    Creates a pull request for the current branch against canary, or splits a cross-layer branch into ordered stacked PRs so backend changes merge before their callers.

    83k GitHub stars~3.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Managing Git Workflow

    hashintel/hash

    Git and pull-request workflow for HASH, including conditional Linear conventions and merge-queue diagnostics.

    1.7k GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed
  • GitHub PR Workflow

    RedWoodOG/Hermes-Desktop

    Full pull request lifecycle — create branches, commit changes, open PRs, monitor CI status, auto-fix failures, and merge.

    177 GitHub starsUsed in 5 repos~2.5k tokens
    DevelopmentAuto-check: notes

More from wordpress-mobile/WordPress-Android

  • Run Jetpack Android App

    wordpress-mobile/WordPress-Android

    Builds the Jetpack debug app with Gradle and installs it on a connected Android device or an emulator started from an available AVD.

    3.2k GitHub stars~886 tokensUpdated today
    Auto-check passed
  • Android Code Quality Checker

    wordpress-mobile/WordPress-Android

    Runs detekt, checkstyle, and Android lint together, reads their reports, and proposes approved fixes grouped by file.

    3.2k GitHub stars~587 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Draft Pull Request Creator

What does Draft Pull Request Creator do?

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. The skill runs nine steps. It checks git status, diff and log, summarizes the changes and asks permission before committing or pushing.

When should I use Draft Pull Request Creator?

Draft Pull Request Creator fits situations like: opening a draft pull request for the branch you are working on; writing a PR description that follows the repository template; committing and pushing changes without staging secrets by accident.

How do I install Draft Pull Request Creator in Claude Code?

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

How do I install Draft Pull Request Creator in Codex?

Run `npx skills add wordpress-mobile/WordPress-Android --skill draft-pr -a codex`. Or copy the skill folder (.claude/skills/draft-pr in wordpress-mobile/WordPress-Android) into .agents/skills/draft-pr in your project. Codex loads it when a task matches its description.

Can I use Draft Pull Request Creator 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 wordpress-mobile/WordPress-Android --skill draft-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/draft-pr, .gemini/skills/draft-pr, .github/skills/draft-pr and .opencode/skills/draft-pr in your project.

What does Draft Pull Request Creator need to run?

Going by SKILL.md and its folder, Draft Pull Request Creator needs the command-line tools its instructions call (git and gh). Our summary lists: Git with a configured remote; GitHub CLI (`gh`).

Does Draft Pull Request Creator 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 Draft Pull Request Creator safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Draft Pull Request Creator use?

Draft Pull Request Creator is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Draft Pull Request Creator use?

About 881 tokens (SKILL.md is roughly 3.5k 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 Draft Pull Request Creator?

Skills that share tags, products or a category with Draft Pull Request Creator: React Router Pull Request Creator (remix-run/react-router, 57k stars), Publish Pull Request for taskctl (taskctl/taskctl, 434 stars), Git GitHub Ops (c5inco/compose-pokedexer, 143 stars) and Pull Request Creation (lobehub/lobehub, 83k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Draft Pull Request Creator?

wordpress-mobile (a GitHub organization) maintains it in wordpress-mobile/WordPress-Android, which has 3,153 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 7, 2026.

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