version: "1.0.1" name: gh-ci-triage description: Triage failing PR checks with gh CLI, identify first actionable root cause, and derive exact local repro commands. license: Apache-2.0 compatibility: opencode metadata: project: up-streamer-rust workflow: ci-triage
When to use
Use this skill when a PR reports failing GitHub checks and you need a fast, evidence-backed diagnosis.
Workflow
- Fetch check overview:
gh pr checks <pr-number>gh pr view <pr-number> --json statusCheckRollup
- Inspect failed jobs only:
gh run view <run-id> --log-failed- If needed,
gh run view <run-id> --job <job-id> --log-failed
- Extract first actionable error (not cascaded noise).
- Map failure to local repro command using the exact workflow flags.
- After fix, rerun local repro commands before pushing.
- Re-check status:
Guardrails
- Do not assume root cause from PR title/last commit; use failed logs.
- Distinguish no-feature lint failures from feature-enabled failures.
- Prefer minimal-scope fixes; avoid broad suppression (
#[allow(...)]) unless required.
Report template
Always report:
- Failing workflow/job name
- First actionable error line(s)
- Root cause hypothesis
- Exact local repro command
- Fix applied
- Post-fix local verification commands and results