Skip to main content
skill CX Codex

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

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

What 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.md and draft the commit with a push.

How to install contributing

1Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill contributing -a claude-code

2Manually: put the files in place

~/.claude/skills/contributing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/contributing/

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.

contributing ZaxbyHub contributing walks an agent through the full pull-request cycle in the opencode-swarm repo: branch naming, commit format, a release-notes fragment, local checks and the PR template. CX Codex +1 ★ 539repo stars flag-and-release-change launchdarkly flag-and-release-change — a skill for Claude Code takes a pull request from flag review to an automated LaunchDarkly release. It updates the PR branch after approval. CX Codex +1 267installs om-auto-update-changelog open-mercato om-auto-update-changelog drafts a CHANGELOG.md entry for every PR merged since the last release, then hands the edit to om-auto-create-pr. Built for release time. CX Codex +1 4,100installs landing-report garrytan landing-report is a Claude Code skill that inspects release version queues across parallel workspaces. Runs read-only checks via the gstack-next-version tool without modifying project files. CX Codex +1 336installs changelog-draft dominikmartn changelog-draft is a Claude Code skill that turns pull requests merged between two release tags into a changelog draft, keeping explicit CHANGELOG markers and sorting the rest into categories. CX Codex +1 ★ 720repo stars branching-strategy-wasp-drone Legion Code Inc. branching-strategy-wasp-drone — a subagent that guides your team through selecting a Git branching model (trunk-based development, GitHub Flow, GitFlow) and resolving merge pain, release workflows, and feature-flag trade-offs. CX Codex ★ 96repo stars om-auto-create-pr open-mercato om-auto-create-pr converts an arbitrary task brief into an autonomous development run, from execution tracking to a ready PR. Operates in an isolated git worktree with incremental commits. CX Codex +1 4,700installs

From the same set121

The whole set →
unswarm unswarm turns off the ongoing swarm workflow in the current thread and returns the agent to direct task execution. Use it when extra planning and review are no longer wanted. CX Codex +1 ★ 539repo stars swarm-implement The swarm-implement skill for Claude Code takes a feature or bug fix from exploration through validation, following the repo's canonical SKILL.md. CX Codex +1 ★ 539repo stars research-first research-first forces agents to verify repo facts and external sources before planning or writing code. CX Codex +1 ★ 539repo stars qa-sweep The qa-sweep skill runs an independent QA pass after implementation or debugging, inspecting the diff and changed files before focused validation. CX Codex +1 ★ 539repo stars mock-to-internals-migration mock-to-internals-migration guides test migrations away from Bun mock.module leaks toward dependency-injection seams using _internals. CX Codex +1 ★ 539repo stars pr-review-fix This compatibility skill routes older pr-review-fix calls to the swarm-pr-feedback workflow for handling pull request feedback. CX Codex +1 ★ 539repo stars tech-debt-ci-review tech-debt-ci-review audits technical debt and shaky CI: test theater, flaky runs, green builds hiding a break. You get findings tied to files and lines, plus a fix order. CX Codex +1 ★ 539repo stars guardrail-patterns guardrail-patterns guides agents when editing destructive-command guards in opencode-swarm, setting document reading order and adversarial testing rules. CX Codex +1 ★ 539repo stars

Project sponsors

Companies that keep this analytics open