# Gentle AI Collab Perfect

Trigger: contributing to Gentleman-Programming/gentle-ai as an external collaborator.

- Repository: https://github.com/Gentleman-Programming/gentle-ai (8170 stars)
- Category: Git and review
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-collab-perfect -g -a claude-code -y`
Codex: `npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-collab-perfect -g -a codex -y`
Cursor: `npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-collab-perfect -g -a cursor -y`
Gemini CLI: `npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-collab-perfect -g -a gemini-cli -y`

## Description

Trigger: contributing to Gentleman-Programming/gentle-ai as an external collaborator. Strict issue-first workflow, honest PR bodies, contributor-vs-maintainer scope, chained-PR strategy, verification protocol, docstring coverage. Load whenever the active repo is Gentleman-Programming/gentle-ai and any part of the contribution flow is in scope: opening an issue, drafting or editing a PR body, splitting a change into chained/stacked PRs, or auditing a PR before requesting review.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## When to use

Use this skill when the active repo is `Gentleman-Programming/gentle-ai` and the contributor is an external collaborator (not the maintainer). Scope of the skill:

- Opening or commenting on issues
- Drafting, editing, or auditing PR bodies
- Choosing a chained-PR strategy (Stacked vs Feature Branch Chain)
- Cross-checking PR claims against the GitHub API
- Deciding whether an action is contributor-scope or maintainer-scope

Do NOT load this skill for:

- Using gentle-ai as an installer (Gentleman-Programming/gentle-ai is the installer itself; not this skill)
- Reading docs, debugging tests, or reviewing the codebase in general
- Tasks on a different repository

The skill assumes the contributor is working from wherever they push, a fork, a personal working repo, or anywhere they have write access. **It deliberately does not assume a fork.** Use it whether you push to `ardelperal/gentle-ai`, to a personal fork, or to a contributor org.

---

## Source of truth, inspect the repo, don't infer

Before any target-host read, obtain explicit authorization for the remote destination (exact target), read operation and credential/session; never probe ambient credentials. Locally, before recommending any contribution action, inspect the relevant current source. The repo documents every constraint; pulling rules verbatim beats guessing.

The rest: https://github.com/Gentleman-Programming/gentle-ai/blob/HEAD/skills/gentle-ai-collab-perfect/SKILL.md