Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

fix(skills): poll only required checks in CI monitoring (#1403)

worktrunk-bot6aa1d0344d8b
diff --git a/.claude/skills/release/SKILL.md b/.claude/skills/release/SKILL.md
index a87a75bc3..8ca666faf 100644
--- a/.claude/skills/release/SKILL.md
+++ b/.claude/skills/release/SKILL.md
@@ -24,7 +24,7 @@ description: Worktrunk release workflow. Use when user asks to "do a release", "
```
9. **Merge to main**: `wt merge --no-remove` (rebases onto main, pushes, keeps worktree)
10. **Tag and push**: `git tag vX.Y.Z && git push origin vX.Y.Z`
-11. **Wait for release workflow**: Poll with `gh pr checks` or `gh run view <run-id>` every 60 seconds until complete (avoid `gh run watch` — it can hang)
+11. **Wait for release workflow**: Poll with `gh pr checks --required` or `gh run view <run-id>` every 60 seconds until complete (avoid `gh run watch` — it can hang). Non-required checks are ignored
The tag push triggers the release workflow which builds binaries and publishes to crates.io, Homebrew, and winget automatically.
diff --git a/.claude/skills/review-pr/SKILL.md b/.claude/skills/review-pr/SKILL.md
index f466ff663..cea4037bc 100644
--- a/.claude/skills/review-pr/SKILL.md
+++ b/.claude/skills/review-pr/SKILL.md
@@ -363,23 +363,20 @@ After approving, monitor CI using the poll approach from `/running-in-ci`.
Exclude the current workflow's own check to avoid a circular wait:
```bash
-gh pr checks <number>
+gh pr checks <number> --required
```
-Poll with `gh pr checks` every 60 seconds until all checks complete.
+Poll with `gh pr checks <number> --required` every 60 seconds until all
+required checks complete. Non-required checks (e.g., benchmarks) are ignored —
+do not wait for them.
Then verify final status:
```bash
-gh pr view <number> --json statusCheckRollup \
- --jq '[.statusCheckRollup[]
- | select(env.GITHUB_WORKFLOW == null
- or (.workflowName == env.GITHUB_WORKFLOW | not))]
- | .[]
- | {name, status, conclusion}'
+gh pr checks <number> --required
```
-- **All checks passed** → done, no further action.
+- **All required checks passed** → done, no further action.
- **A check failed** → if it's a flaky test or unrelated infrastructure
failure, no action needed. If the failure is related to the PR changes:
1. Investigate the failure and post a follow-up review (COMMENT) with
diff --git a/.claude/skills/running-in-ci/SKILL.md b/.claude/skills/running-in-ci/SKILL.md
index 59b3aa111..027ad88f8 100644
--- a/.claude/skills/running-in-ci/SKILL.md
+++ b/.claude/skills/running-in-ci/SKILL.md
@@ -46,14 +46,15 @@ After pushing changes to a PR branch, you **must** wait for CI before saying
"done" or reporting completion. A push without green CI is not finished work.
1. Push your changes
-2. Run `gh pr checks <number>` once
-3. If all checks passed, report completion
-4. If checks are still running, poll with `gh pr checks <number>` every 60
- seconds until all checks complete (this may take up to 10 minutes — that's an
- acceptable tradeoff to ensure the bot reports accurate CI status)
-5. If CI fails, diagnose with `gh run view <run-id> --log-failed`, fix issues,
- commit, push, and repeat from step 2
-6. Only after all checks pass, report completion
+2. Run `gh pr checks <number> --required` once
+3. If all required checks passed, report completion
+4. If checks are still running, poll with `gh pr checks <number> --required`
+ every 60 seconds until all required checks complete (this may take up to
+ 10 minutes). Non-required checks (e.g., benchmarks) are ignored — do not
+ wait for them.
+5. If a required check fails, diagnose with `gh run view <run-id> --log-failed`,
+ fix issues, commit, push, and repeat from step 2
+6. Only after all required checks pass, report completion
**Never** post a "done" or "fixed" comment before CI passes. Local tests alone
are not sufficient — CI runs on Linux, Windows, and macOS. If you report
diff --git a/.claude/skills/triage-issue/SKILL.md b/.claude/skills/triage-issue/SKILL.md
index a8e296d0f..b99b4f151 100644
--- a/.claude/skills/triage-issue/SKILL.md
+++ b/.claude/skills/triage-issue/SKILL.md
@@ -132,9 +132,10 @@ note what you tried and skip to step 7.
```
5. Monitor CI using the poll approach from `/running-in-ci`:
```bash
- gh pr checks <pr-number>
+ gh pr checks <pr-number> --required
```
- Poll with `gh pr checks` every 60 seconds until all checks complete.
+ Poll with `gh pr checks <pr-number> --required` every 60 seconds until all
+ required checks complete. Non-required checks (e.g., benchmarks) are ignored.
If CI fails, diagnose with `gh run view <run-id> --log-failed`, fix, and
repeat.