agentleFS
kool7kool7/claude-skills/skills/create-pr/SKILL.md

create-pr

Skill0 starsChanged 45 days agoMITView on GitHub

Create a GitHub PR with structured title [PREFIX-N]:[Type] Title Case and clean bullet-point description. Use when the user asks to open, raise, or create a pull request.

  • Commits and pushes

196 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use update-pr, act-on-feedback and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • MicrosoftSkill

    update-pr

    Update the pull request for the current session. Use when the user wants to push new changes to an existing PR.

    Also in 9 projects that use this

  • MicrosoftSkill

    act-on-feedback

    Act on user feedback attached to the current session. Use when the user submits feedback on the session's changes via the Submit Feedback button.

    Also in 3 projects that use this

  • ModelEngine-GroupSkill

    create-release-note

    从 PR/commit 中自动生成结构化的 Release Notes,并可选创建 GitHub Draft Release。支持 x.y.0 版本合并前一 minor 系列的 release notes。当用户要求生成发布说明、创建 release notes 时触发。参数为版本号和可选的上一版本号。

    Also in 3 projects that use this

  • frostneySkill

    native-nostalgia-stack

    Applies the user's FreePascal toolchain and its build, formatting, hook, and test contracts while leaving project-specific mechanics local. Use when scaffolding or working in a FreePascal project that follows this toolchain.

    Also in 3 projects that use this

  • frostneySkill

    software-engineering-excellence

    Applies the user's engineering standards during substantial technical work: preserve scope, use current evidence, delegate independent parts, and complete authorized outcomes. Use during substantial implementation, debugging, refactoring, or multi-part delivery work.

    Also in 3 projects that use this

  • parkchuSkill

    start-mission

    넥스트스텝(NextStep) 미션을 처음 시작할 때, 미션 저장소를 fork·clone하고 최초 작업 브랜치(step1 등)까지 만들어 준다. gh CLI로 fork하고 clone까지 이어서 처리하며, gh가 없거나 인증이 안 돼 있으면 브라우저 Fork 안내로 폴백한다. 이미 fork/clone돼 있으면 재사용하고 이어서 진행한다(재실행 안전). 사용자가 "미션 시작하려는데 저장소 세팅해줘", "새 미션 시작할래", "fork부터 해줘", "/nextstep:start-mission" 등으로 요청할 때 사용한다.

    Also in 3 projects that use this

  • +1 more from microsoft
  • Other versions196 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 196

    1. microsoft/vscode★ 195ksame name
    2. vercel/next.js★ 143ksame name
    3. penpot/penpot★ 62ksame name
    4. remix-run/react-router★ 57ksame name
    5. moeru-ai/airi★ 51ksame name
    6. ToolJet/ToolJet★ 41ksame name
    7. ueberdosis/tiptap★ 39ksame name
    8. BabylonJS/Babylon.js★ 26ksame name
    9. kortix-ai/suna★ 21ksame name
    10. kortix-ai/CompanyOS★ 21ksame name

    186 more not listed

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository4 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

12 rules. 0 are common, 8 are distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 179 edited versions we read keep these.

  • 8

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Run in parallel using GitHub MCP (never gh CLI or git push):

    line 11
  2. Very specific:

    If the user passed a full PREFIX-N (e.g.

    line 19
  3. Very specific:

    If the user passed only a prefix word (e.g.

    line 20
  4. Very specific:

    If no argument, check the project CLAUDE.md for prefix: CV.

    line 21
  5. Distinctive:

    Read the commits on the current branch that are ahead of main:

    line 25
  6. Distinctive:

    Every word capitalised (Title Case), including prepositions if 4+ letters

    line 51
  7. Distinctive:

    No file names, no function names, no technical internals

    line 53
  8. Distinctive:

    Keep the title portion under 60 characters

    line 54
  9. Distinctive:

    Start with a past-tense verb: Fixed, Added, Removed, Improved

    line 74
  10. Distinctive:

    No section headers, no bold, no sub-bullets

    line 75
  11. Distinctive:

    No mention of Claude, AI, or any attribution

    line 76
  12. Distinctive:

    All lowercase. Hyphens only.

    line 132

“Common” is measured: kept by at least 6 in 10 of the 179 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Create Pull Request

Step 1 — Detect repo and next PR number

Run in parallel using GitHub MCP (never gh CLI or git push):

  • Get repo owner/name: run git remote get-url origin via Bash, parse github.com/{owner}/{repo} from the URL
  • Get current branch: git branch --show-current
  • mcp__github__list_pull_requests (owner, repo, state: all, per_page: 10) → find the highest PR number (the number field, not the CV number in the title). Next PR = highest + 1.

PR title number rule: The CV number in the title equals the next GitHub PR number. If the last PR was #7, title uses CV-8.

Prefix and number rules:

  • If the user passed a full PREFIX-N (e.g. /create-pr TS-711), use it exactly as the title prefix — do not look up or override the number.
  • If the user passed only a prefix word (e.g. /create-pr CV), append the next GitHub PR number: highest existing PR number + 1.
  • If no argument, check the project CLAUDE.md for prefix: CV. If still not found, ask: "What prefix should I use? (e.g. CV, TS-123, AB)"

Step 2 — Understand what changed

Read the commits on the current branch that are ahead of main:

git log main..HEAD --oneline

Also read any description the user gave when invoking the skill. Use both to understand what was done.

Step 3 — Choose the PR type

Pick exactly one — use the most specific match:

TypeWhen
EnhancementNew feature or meaningful improvement users will notice
Bug FixFixes broken behavior that users experienced
FixSmall targeted fix — single issue, narrow scope
ChoreCI, tooling, config, version bumps — no user-facing change
RefactorCode reorganisation, no behavior change
DocsDocumentation only

Step 4 — Compose the title

[{PREFIX}-{N}]: [{Type}] {Title In Title Case}

Rules:

  • Every word capitalised (Title Case), including prepositions if 4+ letters
  • Describes WHAT was done, not HOW — from the user's perspective
  • No file names, no function names, no technical internals
  • Keep the title portion under 60 characters

Good examples:

[CV-8]: [Fix] Windows Path Separator For Line Decorations
[CV-9]: [Enhancement] Auto Run Tests On Missing Coverage
[CV-10]: [Chore] Bump Version To 1.0.0

Bad examples (reject these patterns):

[CV-8]: [Fix] fix findFileInReport backslash bug   ← lowercase, mentions internal name
[CV-8]: [Fix] Fixed The Windows Path Issue         ← past tense in title, vague

Step 5 — Write the description

  • 3–5 bullet points, plain * bullets
  • Plain English — no file names, no function names, no code
  • Each bullet: one concrete thing fixed or added, from the user's perspective
  • Start with a past-tense verb: Fixed, Added, Removed, Improved
  • No section headers, no bold, no sub-bullets
  • No mention of Claude, AI, or any attribution

Good example:

* Fixed line highlights not appearing on Windows — coverage paths use forward slashes but Windows editor paths use backslashes, causing the file lookup to silently fail.
* Sidebar and status bar were already correct since they iterate files directly; only the editor decoration lookup was affected.

Bad example (reject):

## Bug Fix
The `findFileInReport` function was updated to normalize `\\` to `/`...

Step 6 — Create the PR and assign

6a. Create the PR using mcp__github__create_pull_request:

  • owner and repo: from Step 1
  • head: current branch (from Step 1)
  • base: main
  • title: from Step 4
  • body: bullets from Step 5

6b. Immediately after, call mcp__github__update_issue with the PR number returned in step 6a to set assignees and labels in one call:

  • assignees: [owner] — use the repo owner parsed from Step 1, not a hardcoded name
  • labels: pick from the label map below based on the PR type from Step 3

Label rules — always apply ALL that fit, never just one if multiple apply:

ConditionAdd label
Any broken behaviour was fixedbug
Any new feature or improvement was addedenhancement
Changes touch the UI (dashboard, decorations, sidebar, icons, colors)ui
CI, GitHub Actions, publish pipeline, version bumppublish
Docs onlydocumentation

Examples of multi-label combinations (based on real PRs in this repo):

  • Bug fix that also improves a feature → bug + enhancement
  • Bug fix with visual changes → bug + enhancement + ui
  • CI/release change → publish

To decide, read the commits and description — don't guess from type alone. A PR titled [Fix] can still get enhancement if it improves usability alongside fixing a bug.

Output the PR URL when done so the user can see it immediately.

Branch naming reference (use when creating branches before PRs)

fix/short-kebab-description      ← bug fixes
feat/short-kebab-description     ← new features  
chore/short-kebab-description    ← tooling, CI, config
refactor/short-kebab-description ← code cleanup
docs/short-kebab-description     ← documentation

All lowercase. Hyphens only. Under 40 characters total. No ticket numbers in branch names.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.