apple-browsers: Skill for Claude Code

Diagnose CI Failure

Investigate a GitHub Actions workflow failure, classify it, trace test failures back to the local code, and propose a fix.

Prerequisites

This skill requires the GitHub CLI (gh) to be installed and authenticated. Before doing anything else, run:

command -v gh >/dev/null && gh auth status

If gh is not installed, stop and tell the user to install it (brew install gh on macOS) - do not attempt to substitute curl against the GitHub API. If gh is installed but not authenticated, stop and tell the user to run gh auth login. Either way, bail out before resolving inputs.

Inputs

The skill resolves any of the following to a single GitHub Actions run to investigate. gh autodetects the repo from the current working directory's git remote, so you don't need to pass --repo unless the user supplies a URL pointing at a different repo - in which case extract <owner>/<repo> from the URL and pass it explicitly with --repo <owner>/<repo>. Resolve the input first, then start at Step 1 with the resulting run_id and any optional job_id or attempt_number.

Actions run URL

Example: https://github.com/<owner>/<repo>/actions/runs/25519433222 (optionally with /job/<id> or /attempts/N).

Extract run_id, job_id if present, and attempt_number if the URL includes /attempts/N. Use directly. Do not discard the attempt number: all later gh run view commands for this run must include --attempt {attempt_number} so logs and status match the supplied attempt instead of defaulting to the latest attempt.

PR URL

Example: https://github.com/<owner>/<repo>/pull/4752.

Extract the PR number, then resolve as below.

Bare PR number

Example: 4752 or #4752.

gh pr checks <pr_number> --json name,state,link,workflow

Pick the most recent failed check's run URL. If multiple checks failed, prefer the broadest test workflow over lint-only or build-only ones (in the apple-browsers monorepo that's iOS - PR Checks, macOS - PR Checks, DBP - PR Checks).