josedowski/axioma/branch-pr
Claude Code and agent skill by josedowski/axioma
- community
Checking that the SKILL.md file is still in the repository.
Create Gentle AI pull requests with issue-first checks. Trigger: creating, opening, or preparing PRs for review.
Install
npx vskill@latest install josedowski/axioma/branch-prSKILL.md
The same SKILL.md was published earlier as josedowski/axioma/branch-pr.
Gentle AI — Branch & PR Skill
When to Use
Load this skill whenever you need to:
- Create a branch for a new fix or feature
- Open a pull request on Gentleman-Programming/gentle-ai
- Prepare changes for review
Critical Rules
- Every PR MUST link an approved issue —
Closes/Fixes/Resolves #<N>in the PR body, and that issue MUST havestatus:approved. PRs without this are automatically rejected by CI. - Exactly one `type:*` label — apply exactly ONE type label to the PR. CI will reject PRs with zero or multiple type labels.
- 400-line review budget — keep PRs within 400 changed lines (
additions + deletions) or request/obtain maintainer-appliedsize:exceptionwith rationale documented. - Automated checks must pass — see the Automated Checks table below.
- No `Co-Authored-By` trailers — never add AI attribution to commits.
- No force-push to main/master — protected branch.
Workflow
Branch Naming
Branch names must match this pattern:
| Type | Example | |
|---|---|---|
feat/ | feat/user-login | |
fix/ | fix/duplicate-observation-insert | |
docs/ | docs/api-reference-update | |
refactor/ | refactor/extract-query-sanitizer | |
chore/ | chore/bump-bubbletea-v0.26 | |
style/ | style/fix-linter-warnings | |
perf/ | perf/optimize-catalog-loading | |
test/ | test/add-pipeline-coverage | |
build/ | build/update-goreleaser-config | |
ci/ | ci/add-e2e-docker-job | |
revert/ | revert/undo-model-picker-change |
Rules:
- All lowercase
- Use hyphens, dots, or underscores as separators (no spaces, no uppercase)
- Description must be short and descriptive
PR Body Format
The PR body must follow the template at .github/PULL_REQUEST_TEMPLATE.md. All sections are required unless marked optional.
Automated Checks
These checks run on every PR and all must pass before merge:
| Check | What It Verifies | How to Fix | |
|---|---|---|---|
| Check PR Cognitive Load | PR stays within 400 changed lines (additions + deletions) or has size:exception | Split the PR, or request/obtain maintainer-applied size:exception and document the rationale | |
| Check Issue Reference | PR body contains Closes/Fixes/Resolves #N | Add Closes #<N> to the PR body | |
| Check Issue Has `status:approved` | Linked issue has been approved by a maintainer | Wait for maintainer to add status:approved to the issue | |
| Check PR Has `type:*` Label | Exactly one type:* label is applied to the PR | Ask a maintainer to add the correct label; remove extras | |
| Unit Tests | go test ./... passes | Fix failing tests before pushing | |
| Go Format | go run ./internal/gofmtcheck passes | Format malformed Go files before pushing | |
| E2E Tests | cd e2e && ./docker-test.sh passes | Fix failing E2E scenarios before pushing |
Conventional Commits
Commit messages must match this pattern:
Format
Allowed Types
| Type | Purpose | PR Label | |
|---|---|---|---|
feat | New feature | type:feature | |
fix | Bug fix | type:bug | |
docs | Documentation only | type:docs | |
refactor | Code change (no behavior change) | type:refactor | |
chore | Maintenance, dependencies, tooling | type:chore | |
style | Formatting, linting (no logic change) | type:chore | |
perf | Performance improvement | type:feature | |
test | Adding or updating tests | type:chore | |
build | Build system or external deps | type:chore | |
ci | CI configuration | type:chore | |
revert | Reverts a previous commit | matches reverted type |
Breaking Changes
Add ! after the type/scope:
Breaking changes map to type:breaking-change label.
Examples
Commands
Setup
Testing Locally
Open a PR
Check PR Status
Add a Label
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/branch-pr/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/josedowski/axioma/branch-pr)