Skip to content
Get packs

gentle-ai Contributor Workflow

Guides external contributors through issue-first, honest PRs for gentle-ai

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

What it does

When an agent works on the Gentleman-Programming/gentle-ai repository as an outside contributor, this skill makes it follow the project's contribution rules. It has the agent check the repo's own contribution files before acting, insists an issue is approved before any pull request opens, keeps PR descriptions accurate to what GitHub actually shows, and helps split large changes into smaller chained pull requests. It also explains which actions belong to contributors versus maintainers.

Great for

  • External contributors preparing a pull request for gentle-ai
  • Developers who want an agent to draft honest PR bodies and check labels and titles against project rules
  • Maintainers reviewing whether a contributor's PR followed the issue-first workflow

Skip it if

  • Simply installing or using gentle-ai as a tool, since the skill is for contributing to the repo, not using it
  • Working on other repositories, where its rules do not apply
  • Anyone expecting the agent to change labels or merge PRs automatically: the skill forbids automatic mutation and requires explicit human instruction and repository permissions for protected actions

Try asking

  • “Help me open an issue for gentle-ai before I write any code”
  • “Draft a PR body for my gentle-ai change that matches the PR template”
  • “Split this large gentle-ai change into chained PRs under the 400-line budget”
  • “Audit my gentle-ai PR for missing labels, a valid title, and accurate checkboxes before I request review”
Step-by-step guide: how to use gentle-ai Contributor 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.

    gentle-ai-collab-perfect.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip gentle-ai-collab-perfect.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip gentle-ai-collab-perfect.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

  • Give the agent explicit, direct instructions for each label or status change you want; it is designed not to act without them
  • Let the agent re-read CONTRIBUTING.md and the PR template at the start of each contribution, since the rules evolve
  • Use the 400-line budget check early so you can plan chained PRs before writing too much code

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.