commit-pr · zaxbyhub, github — Claude Code skill: commit and PR publication rules
commit-pr — a checklist the agent must clear before it commits, pushes or opens a PR. Built for the case where an AI agent publishes the branch, not a person.
MIT ★ 539 updated 2026-10-29
npx skills add ZaxbyHub/opencode-swarm --skill commit-pr -a claude-codeWhat commit-pr does
A discovery shim rather than a rulebook. It sits at .github/skills/commit-pr/SKILL.md so the Copilot agent can find the publication workflow, then hands it off to one canonical file, .claude/skills/commit-pr/SKILL.md.
The reading order is fixed: AGENTS.md, then docs/engineering-invariants.md, then the canonical skill, then the Codex/Copilot adapter at .agents/skills/commit-pr/SKILL.md. When two of them disagree, the one higher up wins. Until the checklist closes, there is no commit, no push, no gh pr create, gh pr edit or gh pr ready, no rewriting the PR body, and no claim that CI or the merge is ready.
The PR body carries three sections, ## Summary, ## Invariant audit and ## Test plan; when the branch resolves an issue, Closes #<issue-number> goes on the first line. A CI job named pr-standards and a hook named pr-publication-gate enforce the contract. Paths inside the shim are relative to the opencode-swarm layout, so dropping it into an unrelated repo leaves it pointing at nothing.
What it helps with
- Stop the agent from pushing before the checklist passes
- Fill the PR body with the required sections
- Link a pull request to its issue
- Settle which file wins when instructions clash
- Close out remote CI by the book
Example prompts for the agent
- Read
AGENTS.mdand.claude/skills/commit-pr/SKILL.mdbefore you commit, then walk the checklist. - Open the PR with
## Summary,## Invariant auditand## Test plansections. - Check the checklist is done before you mark the PR ready.
How to install commit-pr
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill commit-pr -a claude-code2Manually: put the files in place
~/.claude/skills/commit-pr/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/commit-pr/
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill commit-pr -a codex2Manually: put the files in place
.agents/skills/commit-pr/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill commit-pr -a cursor2Manually: put the files in place
.cursor/skills/commit-pr/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ZaxbyHub/opencode-swarm .github/skills/commit-pr2Manually: put the files in place
.github/skills/commit-pr/SKILL.md1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill commit-pr -a gemini-cli2Platform CLI
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .github/skills/commit-prManually: put the files in place
.devin/skills/commit-pr/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill commit-pr -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about commit-pr
How do I install commit-pr in Claude Code?
Run npx skills add ZaxbyHub/opencode-swarm --skill commit-pr -a claude-code. The skill lands at ~/.claude/skills/commit-pr/SKILL.md.
What does commit-pr do?
It sets a mandatory order for publishing: what to read before committing, which sections the PR body needs, and when the PR may be marked ready. The file itself only routes the agent to the canonical SKILL.md.
Does this file hold the actual rules?
No. It is the GitHub Copilot adapter, kept so the agent finds the workflow under .github/skills. The rules live in .claude/skills/commit-pr/SKILL.md, which outranks the adapters when they conflict.
Source text
SKILL.md · MIT
--- name: commit-pr description: > Mandatory publication protocol for the GitHub Copilot coding agent and custom Copilot agents in opencode-swarm. Load when assigned to an issue or when committing, pushing, opening/updating/readying a PR, writing release notes, or closing out remote CI. Routes to the single canonical commit-pr source of truth. --- # Commit PR (GitHub Copilot adapter) This repository has exactly **one** publication workflow, and it is mandatory. This file is a discovery shim so the GitHub Copilot agent can find the workflow under a `.github/skills` path. It is **not** the source of truth and intentionally duplicates none of the contract. The canonical, authoritative protocol is [`../../../.claude/skills/commit-pr/SKILL.md`](../../../.claude/skills/commit-pr/SKILL.md). Read and follow, in order: 1. [`../../../AGENTS.md`](../../../AGENTS.md) 2. [`../../../docs/engineering-invariants.md`](../../../docs/engineering-invariants.md) 3. [`../../../.claude/skills/commit-pr/SKILL.md`](../../../.claude/skills/commit-pr/SKILL.md) — **single source of truth** 4. [`../../../.agents/skills/commit-pr/SKILL.md`](../../../.agents/skills/commit-pr/SKILL.md) — Codex/Copilot execution adapter If instructions ever conflict, precedence is: `AGENTS.md` → `docs/engineering-invariants.md` → `.claude/skills/commit-pr/SKILL.md` → adapters → this file. Do not commit, push, run `gh pr create`, `gh pr edit`, or `gh pr ready`, edit a PR body, mark a PR ready, or claim CI/merge readiness until the canonical `commit-pr` checklist is satisfied. The required PR title, PR body sections (`## Summary`, `## Invariant audit`, `## Test plan`, plus `Closes #<issue-number>` as the first line *when the PR resolves an issue*), invariant audit, release fragment, validation suite, issue comment, draft/ready behavior, and CI closeout rules all come from [`../../../.claude/skills/commit-pr/SKILL.md`](../../../.claude/skills/commit-pr/SKILL.md). The `pr-standards` CI check and the `pr-publication-gate` hook enforce this contract; do not work around them.
© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm
Similar skills
All skills for Git and GitHub →commit-pr by other authors comes first.