Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ZaxbyHub/opencode-swarm --skill commit-pr -a claude-code
Open on GitHub

What 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.md and .claude/skills/commit-pr/SKILL.md before you commit, then walk the checklist.
  • Open the PR with ## Summary, ## Invariant audit and ## Test plan sections.
  • 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-code

2Manually: put the files in place

~/.claude/skills/commit-pr/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/commit-pr/

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.

commit-pr ZaxbyHub commit-pr — a portable skill that verifies your code before push, writes conventional commits, and fills in a PR body. Guards against accidentally committing generated files or secrets. CX Codex +1 ★ 539repo stars commit-pr ZaxbyHub The commit-pr skill guides commits, pull request updates, and CI checks in opencode-swarm. Use it when publishing issue-related code changes or closing out a PR. CX Codex +1 ★ 539repo stars commit-pr ZaxbyHub Guides an agent through checks, commit preparation, and PR publication. Useful when a change must follow the opencode-swarm release process. CX Codex +1 ★ 539repo stars commit-push-pr sneg55 commit-push-pr automates Git delivery by creating a feature branch, committing changes, pushing upstream, and opening or updating a GitHub pull request. CX Codex +1 ★ 75repo stars ce-commit-push-pr EveryInc The ce-commit-push-pr skill commits changes, pushes the branch, and opens a PR. It can also draft or rewrite a PR description without shipping code. CX Codex +1 3,600installs om-merge-buddy open-mercato om-merge-buddy audits open pull requests against reviews, CI runs, and QA gates to report what can merge right now. Operates purely in read-only mode. CX Codex +1 3,600installs commit-commands official Anthropic commit-commands is a Claude Code plugin with slash commands for commits, pushing branches, and opening pull requests. It also removes local branches deleted from the remote. ★ 47,914repo stars ship-it jssblck ship-it takes a finished change all the way to a ready pull request: commits, pushes, opens the PR and watches CI until it passes. CX Codex +1 1,700installs pr-create Garrick Aden-Buie (@gadenbuie) pr-create is a Claude Code skill that branches, commits changes, opens a GitHub PR, and monitors CI, pushing fixes until checks pass. CX Codex +1 807installs

From the same set121

The whole set →
swarm Enables a rigorous swarm-style posture with parallel searches, visible plan updates, and dual review gates for code changes. CX Codex +1 ★ 539repo stars research-first The research-first skill checks current documentation and discussions before tracing code when an issue depends on an external framework, tool, or platform. For repo-local questions, it searches the repository instead. CX Codex +1 ★ 539repo stars swarm-pr-subscribe swarm-pr-subscribe monitors open pull requests, triages incoming review comments or CI failures, and applies safe fixes until merge. CX Codex +1 ★ 539repo stars swarm-ci-monitor The swarm-ci-monitor skill monitors CI for an approved, reviewed PR, investigates failures, and works through fixes until checks pass. It can then merge the PR after a final review of its state. CX Codex +1 ★ 539repo stars skill-edit-validation skill-edit-validation sweeps test suites for stale assertions after modifying skill markdown files, preventing unexpected CI breaks. CX Codex +1 ★ 539repo stars discover This skill delegates repository discovery and maps project rules, code structure, and risk areas. Use it before a complex change when you need to understand the existing project first. CX Codex +1 ★ 539repo stars ci-fix-monitor ci-fix-monitor is a Claude Code skill that monitors pull request check runs and resolves CI failures. It tracks builds until every required job turns green. CX Codex +1 ★ 539repo stars swarm-resume swarm-resume is a Claude Code skill that restores swarm plan state and clears stale git branches to resume work on an approved plan. CX Codex +1 ★ 539repo stars

Project sponsors

Companies that keep this analytics open