check-pr-ci-status

Check PR CI Status

Check the CI check status on a GitHub pull request and detect whether any failures are new since the last check. This enables efficient CI monitoring — only act on new failures, not stale ones that were already addressed.

When to Use This Skill

Use this skill when you need to:

• Check if a PR has any failing CI checks
• Detect new CI failures that appeared since your last check
• Decide whether CI failures need attention in an agentic workflow
• Build a polling loop that reacts to CI status changes

Prerequisites

1. gh CLI: Authenticated with gh auth login
2. Repository read access: The token must have permission to view PR check status

Implementation

Basic usage

result=$(bash "${CLAUDE_PLUGIN_ROOT}/skills/check-pr-ci-status/check_pr_ci_status.sh" \
  --repo owner/repo \
  --pr 123)

With previous failure tracking

result=$(bash "${CLAUDE_PLUGIN_ROOT}/skills/check-pr-ci-status/check_pr_ci_status.sh" \
  --repo owner/repo \
  --pr 123 \
  --previous-failures "ci/prow/e2e-aws ci/prow/unit")

Parameters

Parameter	Required	Description
--repo	Yes	GitHub repository in owner/repo format
--pr	Yes	Pull request number
--previous-failures	No	Space-separated check names that were failing on the last check

Output

JSON on stdout:

{
  "failing_checks": [
    {"name": "ci/prow/e2e-aws", "state": "FAILURE"},
    {"name": "ci/prow/unit", "state": "FAILURE"}
  ],
  "failing_count": 2,
  "failing_names": "ci/prow/e2e-aws ci/prow/unit",
  "has_new_failures": true,
  "formatted": "- ci/prow/e2e-aws (FAILURE)\n- ci/prow/unit (FAILURE)"
}

Using in a polling loop

The failing_names field is designed to be passed back as --previous-failures on the next call:

LAST_FAILURES=""

while true; do
  sleep 300

  result=$(bash "${CLAUDE_PLUGIN_ROOT}/skills/check-pr-ci-status/check_pr_ci_status.sh" \
    --repo owner/repo --pr 123 --previous-failures "$LAST_FAILURES")

  has_new=$(echo "$result" | jq -r '.has_new_failures')
  if [[ "$has_new" == "true" ]]; then
    formatted=$(echo "$result" | jq -r '.formatted')
    echo "New CI failures detected:"
    echo "$formatted"
    # Address failures...
  fi

  LAST_FAILURES=$(echo "$result" | jq -r '.failing_names')
done