Skip to main content
skill CX Codex

swarm-ci-monitor · zaxbyhub — Codex skill: CI monitoring and setup

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.

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

swarm-ci-monitor handles a PR that has already been reviewed and approved. It checks CI, investigates failures, applies fixes, and repeats the cycle until checks pass, for up to five cycles. Before merging, it checks the PR state again; afterward, it must confirm the result through local Git. Passing checks alone are not enough.

In Codex, the skill uses GitHub MCP tools to read check results and job logs. Use ToolSearch to verify that the tools are available; the remote environment does not use gh. Merging requires an available MCP merge tool. If that tool cannot be found, the user must merge manually. Load commit-pr before committing or pushing fixes, and ci-fix-monitor for failure-specific fix recipes.

What it helps with

  • check CI for a reviewed and approved PR
  • retrieve job logs for failed checks
  • investigate failures and apply fixes
  • repeat checks and fixes for up to five cycles
  • recheck a PR before merging and confirm the result through local Git

Example prompts for the agent

  • Monitor CI for this approved PR and fix failures until the checks pass.
  • Inspect the failed job logs for this PR and work out the fixes.
  • Recheck the PR before merging, then confirm the merge through local Git.

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 do I install swarm-ci-monitor in Codex?

Run npx skills add ZaxbyHub/opencode-swarm --skill swarm-ci-monitor -a codex. The skill file is placed at .agents/skills/swarm-ci-monitor/SKILL.md.

What does swarm-ci-monitor do?

It monitors CI for a reviewed, approved PR, investigates failures, and repeats the fix-and-check cycle for up to five rounds. It then rechecks the PR before merging and confirms the result through local Git.

What is required to merge a PR with swarm-ci-monitor?

Check with ToolSearch that the MCP merge tool is available in the Codex session. If it is unavailable, merge manually; the workflow does not fall back to gh.

Source text

SKILL.md · MIT
---
name: swarm-ci-monitor
description: Codex 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.
metadata:
  audience: swarm-plugin
---

# Swarm CI Monitor

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

## Codex Execution Notes

- MCP tool names (`mcp__github__*`) are injected by the runtime harness and
  may differ across environments; verify availability via `ToolSearch` before
  first use in a session.
- No `gh` CLI in the remote/MCP environment. Use MCP tools instead:
  - PR checks → `mcp__github__pull_request_read` method `get_check_runs`
  - Failure logs → `mcp__github__get_job_logs` with `job_id`, `return_content: true`
  - PR mergeable/mergeStateStatus/reviewDecision → `mcp__github__pull_request_read` method `get`
- **Merge is new surface area.** There is no `mcp__github__merge_pull_request`
  reference anywhere else in the repo. Verify availability via `ToolSearch`
  before first use in a session. If the tool is unavailable, do not attempt a
  fallback that contradicts the "no `gh` CLI" premise above — surface to the
  user that the merge must be done manually. "`ToolSearch` didn't confirm the
  tool but I'll try it anyway" is not acceptable for the one action in this
  skill that cannot be safely undone — surface to the user instead.
- Do not soften Step 1's pre-flight gates or Step 3's pre-merge re-check —
  this is the first skill in the repo authorized to execute a merge.
- Load `../commit-pr/SKILL.md` before committing or pushing any fix, 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 until the post-merge local-git confirmation (Step 4b)
  passes. Green checks alone are not sufficient.

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

Similar skills

All skills for DevOps and infrastructure →

swarm-ci-monitor by other authors comes first.

swarm-ci-monitor ZaxbyHub swarm-ci-monitor monitors CI runs on approved pull requests, repairs broken checks within five cycles, and merges the branch once tests pass. 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 V3 Swarm Coordination ruvnet V3 Swarm Coordination orchestrates a 15-agent hierarchical mesh swarm to implement claude-flow v3. Manages parallel execution across security, core, and integration domains over a 14-week plan. CX Codex +1 1,100installs qcsd-cicd-swarm proffesor-for-testing The qcsd-cicd-swarm Claude Code skill checks CI/CD pipelines before release and assesses deployment readiness. It reviews regression risk and flaky tests, then returns a RELEASE, REMEDIATE, or BLOCK decision. CX Codex +1 104installs monitor-ci nrwl monitor-ci tracks Nx Cloud CI runs and orchestrates self-healing build repairs via MCP. Useful when automating pull request checks and test fixes. CX Codex +1 2,000installs crontap-uptime-monitor Crontap crontap-uptime-monitor configures Crontap HTTP endpoint monitoring from Claude Code. It sets up health checks, defines failure thresholds, pauses monitors during releases, and inspects probe logs. CX Codex +1 1,300installs monitor-stream ruvnet monitor-stream is a Claude Code skill that streams swarm changes through Monitor. It starts live status tracking for agent activity. CX Codex +1 746installs render-monitor Render render-monitor — a skill that checks Render service health from your agent: status, metrics, logs, deploys and databases. CX Codex +1 580installs

From the same set121

The whole set →
worktree-retry-cleanup worktree-retry-cleanup is a Claude Code skill that cleans up a swarm worktree lane before a task is dispatched again. CX Codex +1 ★ 539repo stars 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 commit-pr 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. 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

Project sponsors

Companies that keep this analytics open