ci-watch

Poll GitHub PR CI checks until completion using gh commands.

4|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/danmestas/wardrobe --skill ci-watch-danmestas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ci-watch
Source: https://github.com/danmestas/wardrobe/tree/main/skills/ci-watch
Command: npx skills add https://github.com/danmestas/wardrobe --skill ci-watch-danmestas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CI-dependent workflows require monitoring external checks to determine readiness for merge or deployment, causing delays if done manually.

Core Features & Use Cases

  • Monitor PR CI status via gh pr checks and gh run watch.
  • Implement cadence-based polling to balance timely updates with API limits.
  • Gate actions when CI is green and surface actionable failure signals.

Quick Start

Invoke the skill to watch a PR's CI checks until completion.

Frequently Asked Questions about ci-watch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor GitHub PR CI checks until they complete?

To monitor GitHub PR CI checks until completion, the skill uses cadence-based polling via gh pr checks and gh run watch. It distinguishes flakes from real failures and returns exit code 0 when green, 1 for failure, and 8 if still pending.

What is the best way to automate watching CI workflows for a pull request?

Automating CI workflows for a pull request involves polling GitHub checks at specific cadences to balance timely updates with API limits. This approach gates downstream actions when CI is green and surfaces actionable failure signals if checks fail.

Can I use gh run watch to distinguish flaky CI checks from real failures?

Yes, you can distinguish flaky CI checks from real failures by using cadence-based polling with gh run watch. The skill monitors check status over intervals to identify transient failures before reporting a final failure exit code.

Does this CI polling skill support gating actions when checks are green?

Yes, the CI polling skill supports gating actions when checks are green. It returns exit code 0 upon successful completion, allowing you to trigger downstream merge or deployment workflows automatically.

Why do my GitHub PR checks show pending status during automated polling?

GitHub PR checks show a pending status during automated polling because the CI workflows are still running. The skill uses exit code 8 to indicate this pending state, continuing to poll until all checks reach a final green or failure state.