Skip to main content
skill CX Codex

swarm-ci-monitor · zaxbyhub, claude — Claude Code skill: what it does, how to install

swarm-ci-monitor monitors CI runs on approved pull requests, repairs broken checks within five cycles, and merges the branch once tests pass.

MIT ★ 539 updated 2026-10-29

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

What swarm-ci-monitor does

This skill handles the final stage of an approved pull request inside opencode-swarm. It watches CI runs via the GitHub CLI tool gh. When test suites fail, the skill parses logs and pulls repair recipes from ci-fix-monitor. Then it commits code updates according to commit-pr guidelines. It repeats this repair loop up to five times.

The agent holds exclusive permission to run gh pr merge within the repository. To avoid merging broken code, it runs pre-flight gates and re-evaluates branch freshness before sending the merge call.

Passing tests in the GitHub API do not trigger an immediate success signal. A local git check acts as an independent safety barrier before the job concludes. Without the gh command-line utility, the agent cannot execute these steps.

What it helps with

  • monitor pull request CI runs until all checks turn green
  • diagnose test failures and apply code fixes automatically
  • merge approved pull requests using gh pr merge
  • verify branch status through local git before closing tasks

Example prompts for the agent

  • Monitor CI for PR #42, fix failing checks, and merge when green
  • Watch the approved pull request, repair broken builds, and finish the merge
  • Start CI monitoring on this branch and resolve pipeline failures

How to install swarm-ci-monitor

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/swarm-ci-monitor/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/swarm-ci-monitor/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about swarm-ci-monitor

How to install swarm-ci-monitor in Claude Code?

Run npx skills add ZaxbyHub/opencode-swarm --skill swarm-ci-monitor -a claude-code.

What does swarm-ci-monitor do?

It monitors CI pipelines for approved pull requests, repairs failing checks across up to five cycles, and executes gh pr merge.

What happens if CI checks keep failing?

The skill stops after a limit of 5 fix iterations if checks remain red.

Source text

SKILL.md · MIT
---
name: swarm-ci-monitor
description: >
  Claude Code adapter for end-to-end CI monitoring of an already-reviewed PR
  in opencode-swarm. Use when the user wants the swarm to monitor a
  reviewed-and-approved PR's CI, research every failure exhaustively, fix
  end-to-end, iterate until green (max 5 cycles), then merge. Composes
  ci-fix-monitor for fix recipes. This is the first skill in the repo that
  executes a merge — invoke it deliberately.
disable-model-invocation: true
metadata:
  audience: swarm-plugin
---

# Swarm CI Monitor

Read and follow `../../../.opencode/skills/swarm-ci-monitor/SKILL.md` as the
canonical workflow.

## Claude Code Execution Notes

- `gh` CLI is available natively; use it directly for every step (checks,
  merge, git operations) — the canonical's MCP tool-mapping table is for the
  Codex adapter, not this environment.
- This is the first skill in the repo authorized to execute `gh pr merge`. Do
  not soften or skip the pre-flight gates (Step 1), the pre-merge staleness
  re-check (Step 3), or the post-merge local-git confirmation (Step 4b) — they
  are the load-bearing safety mechanism, not optional ceremony.
- Load `../commit-pr/SKILL.md` before any commit/push inside the fix loop, and
  `../../../.opencode/skills/ci-fix-monitor/SKILL.md` for
  failure-type-specific fix recipes, as the canonical's Composition section
  directs.
- Do not declare victory on green checks alone — Step 4b's local-git
  confirmation, via a different system than the GitHub API, is the
  independent gate.

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

Similar skills

All skills for Git and GitHub →

swarm-ci-monitor by other authors comes first.

swarm-ci-monitor ZaxbyHub 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 swarm-ci-monitor ZaxbyHub swarm-ci-monitor is a Claude Code skill that monitors approved PRs, diagnoses CI failures, applies fixes for up to five cycles, and merges when required checks pass. CX Codex +1 ★ 539repo stars om-auto-merge-buddy open-mercato om-auto-merge-buddy — a skill for Claude Code processes pull requests labeled automerge and merges them once verified. Coordinates review, QA, and CI checks without blocking on slow pipelines. CX Codex +1 465installs coco-ship coco-research coco-ship guides code from branch to GitHub pull request while handling corporate git guards and waiting on CI checks. Blocks direct pushes to main. CX Codex +1 ★ 328repo stars pr alirezarezvani Creates a pull request from the current branch to a target branch. Verifies local checks and CI workflows before submitting the PR to GitHub. CX Codex +1 ★ 907repo stars ops-merge Lifecycle Innovations Limited The ops-merge Claude Code skill scans repositories, sends subagents to fix issues in open pull requests, and merges those that are ready. It automates PR merging. CX Codex +1 ★ 3,785repo stars gitnexus-pr-swarm-review abhigyanpatwari The gitnexus-pr-swarm-review skill splits a pull request review across seven subagents and assembles a production-readiness report. It is built for on-demand PR analysis. CX Codex +1 438installs routines official Anthropic routines is a Claude Code skill that prepares recurring work for /schedule. It covers PR digests, stale guidance checks, and progress updates. CX Codex +1 ★ 47,914repo stars

From the same set121

The whole set →
grep-for-mock-module-across-the-entire-test-file-and-confirm-eve grep-for-mock-module-across-the-entire-test-file-and-confirm-eve is a Claude Code skill that checks every mock.module call in a test file for real-export spreads during a Vitest-to-Bun migration. CX Codex +1 ★ 539repo stars codebase-review-swarm codebase-review-swarm runs quote-grounded code reviews and security or QA audits without editing project files. Built for deep inspections across entire codebases or large subsystems. CX Codex +1 ★ 539repo stars run-relevant-tests-after-adding-error-handling-wrappers run-relevant-tests-after-adding-error-handling-wrappers is a Claude Code skill that prompts an agent to run relevant tests after adding error handling and check the success path's original return type and value. CX Codex +1 ★ 539repo stars issue-tracer issue-tracer walks a bug from reproduction to a PR-ready fix: locate the cause, plan the patch, get it reviewed. CX Codex +1 ★ 539repo stars restore-internals-seams-in-finally-blocks-after-each-test restore-internals-seams-in-finally-blocks-after-each-test is a Claude Code skill that directs agents to restore original _internals in finally after each test of error paths through DI seams. CX Codex +1 ★ 539repo stars check-skill-provenance-stamps-before-archiving-knowledge-entries check-skill-provenance-stamps-before-archiving-knowledge-entries is a Claude Code skill that checks source_refs and UUIDs before archiving knowledge entries, stopping removal if an active skill depends on one. CX Codex +1 ★ 539repo stars consult consult enforces an advisory protocol with strict read-before-cite checks and explicit uncertainty levels. CX Codex +1 ★ 539repo stars run-affected-test-suite-end-to-end-after-multi-file-signature-ch run-affected-test-suite-end-to-end-after-multi-file-signature-ch is a Claude Code skill that runs affected tests and checks every call site after function signatures change across files. CX Codex +1 ★ 539repo stars

Project sponsors

Companies that keep this analytics open