Skip to main content
ClaudeWave
Skill349 repo starsupdated today

commit-pr

The commit-pr skill standardizes pull request creation and validation within the opencode-swarm repository by enforcing a mandatory workflow that includes required PR title formatting, body sections (Summary, Invariant audit, Test plan), issue linking, and invariant compliance checks. Use this skill before creating or modifying pull requests to ensure all contributions meet the repository's engineering standards and pass automated CI gates.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/zaxbysauce/opencode-swarm /tmp/commit-pr && cp -r /tmp/commit-pr/.github/skills/commit-pr ~/.claude/skills/commit-pr
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# 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.