Skip to content

Branch PR Helper

Guides contributors through opening a pull request that links an approved issue and follows project rules.

Stars
8,181
Licence
MIT
Files
1 file

What it does

When installed, this skill tells an AI agent how to prepare a pull request for the Gentle AI project. Before drafting one, the agent must check that a linked issue is approved, name the branch using the required pattern (for example feat/ or fix/), and fill in the project's PR template, including the labels and checklist. It also stops the agent from committing, pushing, creating, or merging a PR on its own, leaving those steps to a human.

Great for

  • Contributors to the Gentle AI repository who need to open a compliant pull request
  • Maintainers who want an AI assistant to follow the project's issue-first and labelling rules

Skip it if

  • Projects other than Gentle AI, since the issue, label, and CI rules are specific to that repository
  • Anyone expecting the agent to push or merge automatically, because the skill deliberately requires a human to do those steps

Try asking

  • “Help me open a PR for my change to the installer, linked to issue 42”
  • “Prepare a branch name and PR body for my docs fix”
  • “Check whether my PR has the right type label and issue reference before I submit”
Step-by-step guide: how to use Branch PR HelperInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    branch-pr.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip branch-pr.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip branch-pr.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Approve the linked issue and confirm the closing or non-closing reference before asking the agent to draft the PR
  • Give explicit permission for each remote read or write action, since the skill requires it before touching the repository host
  • Run the local tests (go test, gofmtcheck) yourself and report results so the checklist is only ticked on real evidence

What's inside

  • SKILL.md

Redistributed unmodified from Gentleman-Programming/gentle-ai under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.