Skip to content
Get packs

Gentle AI Branch and PR Workflow

Opens branches and pull requests for the gentle-ai repo following its issue-first and review-size rules.

Source Download skill
Repository
Gentleman-Programming/gentle-ai
Stars
8,181
Licence
MIT
Files
1 file

What it does

Once installed, the agent follows the gentle-ai project's contribution rules when preparing code changes: it checks that a linked, approved issue exists, names branches with the required prefixes (feat/, fix/, docs/, etc.), keeps pull requests under about 400 changed lines, fills in the project's PR template, and avoids AI attribution trailers in commits. It is designed to stop and ask a human before it commits, pushes, creates PRs, or changes protected labels.

Great for

  • Contributors to the Gentleman-Programming/gentle-ai repository who want an agent to follow its PR conventions
  • Maintainers who want consistent branch names, issue links and PR templates across agent-made contributions

Skip it if

  • Projects other than gentle-ai: the rules, labels and template paths are specific to that repository and would not apply elsewhere.
  • Situations where an agent should act without human sign-off: the skill relies on explicit human authorization for pushes, PR creation and label changes, so it is not useful for fully automated publishing.

Try asking

  • “Create a branch for a fix to the duplicate observation insert bug and prepare the PR body.”
  • “Check whether my linked issue has status:approved before I open a pull request.”
  • “Draft a PR description using the repository's template and list only the checks I actually ran.”
  • “Pick the correct branch name and type label for my refactor of the query sanitizer.”
Step-by-step guide: how to use Gentle AI Branch and PR WorkflowInstall, 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

  • Provide the issue number and whether the PR should close it on merge (Closes) or only reference it (Refs) before the agent starts, since it will ask.
  • Grant remote read access for one specific repository and session; the skill will not probe ambient credentials on its own.
  • Review every label change and PR body yourself; the skill is designed to leave unverified checkboxes unchecked and record pending actions separately.

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.