contributing · zaxbyhub — Codex skill: contribution checklist for opencode-swarm
contributing is a Claude Code skill that maps commits, test runs and PRs to the opencode-swarm checklist, including the required release fragment.
MIT ★ 539 updated 2026-10-29
npx skills add ZaxbyHub/opencode-swarm --skill contributing -a claude-codeWhat contributing does
This skill is the Claude-facing adapter for the opencode-swarm contributor checklist. The rules themselves sit in .opencode/contributing/SKILL.md; the skill lays out the order of operations, meaning which companion to load before a commit, a test run or an invariant-sensitive edit.
Four companions get named. .agents/skills/commit-pr/SKILL.md covers commits, pushes and PR updates, running-tests handles running the suite, writing-tests covers authoring, and engineering-conventions is for changes that touch invariants. Two hard rules come with them: release-please-owned files stay untouched by hand, and a user-visible PR needs a pending release fragment under docs/releases/pending/.
The fragment is not paperwork. A user-visible change without one fails the checklist, and rewriting the generated release files is not a substitute for adding a new fragment.
What it helps with
- write a release fragment for a user-visible change
- walk the branch and PR checklist before publishing
- pick the right companion skill for commits, tests or invariant work
- check work against the canonical list in
.opencode/contributing/SKILL.md - keep release-please-owned files out of manual edits
Example prompts for the agent
- Check my branch against the contributor checklist before I open the PR.
- Add a pending release fragment under
docs/releases/pending/for this change. - Load
.agents/skills/commit-pr/SKILL.mdand draft the commit with a push.
How to install contributing
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill contributing -a claude-code2Manually: put the files in place
~/.claude/skills/contributing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/contributing/
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill contributing -a codex2Manually: put the files in place
.agents/skills/contributing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill contributing -a cursor2Manually: put the files in place
.cursor/skills/contributing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ZaxbyHub/opencode-swarm .agents/skills/contributing2Manually: put the files in place
.github/skills/contributing/SKILL.md1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill contributing -a gemini-cli2Platform CLI
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .agents/skills/contributingManually: put the files in place
.devin/skills/contributing/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill contributing -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 contributing
How do I install the contributing skill in Claude Code?
Run npx skills add ZaxbyHub/opencode-swarm --skill contributing -a codex, and the skill lands at .agents/skills/contributing/SKILL.md.
What does contributing do?
It adapts the opencode-swarm contributor checklist for Claude: it points at the canonical rule list and tells you which companion skill to load for each step.
Do user-visible PRs need a release note?
Yes, a pending fragment under docs/releases/pending/. Files owned by release-please are not edited by hand.
Source text
SKILL.md · MIT
--- name: contributing description: Codex adapter for the opencode-swarm contribution checklist. Use when preparing user-visible changes, release note fragments, local validation, branch hygiene, PR checklist items, or contribution-policy compliance before publishing work. metadata: audience: swarm-plugin --- # Contributing Read `.opencode/contributing/SKILL.md` for the canonical contribution checklist. Codex-specific execution notes: - For commits, pushes, PR creation, PR updates, and CI closeout, load `.agents/skills/commit-pr/SKILL.md`. - For test execution details, load `.agents/skills/running-tests/SKILL.md`. - For test authoring, load `.agents/skills/writing-tests/SKILL.md`. - For invariant-sensitive changes, load `.agents/skills/engineering-conventions/SKILL.md`. Do not hand-edit release-please-owned files. User-visible PRs need a pending release fragment under `docs/releases/pending/`.
© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm
Similar skills
All skills for Agent setup: memory, context, orchestration →contributing by other authors comes first.