modules/programs/agents/shared/skills/monitor-pr/SKILL.md
Watch an open PR's CI and bot comments; on relevant failure or new bot feedback, invoke `fix-pr`. Exit when the PR is clean or stuck. Use when user says "monitor PR", "watch CI", or wants hands-off CI shepherding without a merge step.
npx skillsauth add MichaelVessia/nixos-config monitor-prInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Arguments: $ARGUMENTS (optional PR number or URL; else current branch PR).
Execute fully, stop only if blocked or stuck past the attempt budget.
$ARGUMENTS has a PR URL/number, use it. Else gh pr view on current
branch.Poll checks + bot/reviewer comments together. Max 120 iterations, 60s apart (~2h). On each iteration:
gh pr view <PR> --json statusCheckRollup --jq '
.statusCheckRollup[] | [.name, .status, .conclusion] | @tsv
'
gh pr view <PR> --json comments,reviews --jq '
[.comments[], .reviews[]]
| map(select(
.author.is_bot == true
or (.author.login | test("bot|copilot|dependabot|renovate|coderabbit"; "i"))
))
| length
'
gh pr diff --name-only to decide
relevance: touched files, lint, typecheck, build, tests tied to changed
code.) Break, go to step 3.sleep 60, continue.Invoke fix-pr with the PR number. It handles failing checks, comments,
commits, pushes, replies.
After fix-pr returns, re-enter step 2. Max 3 total fix-pr invocations.
After the third attempt, proceed to step 4 regardless of outcome.
Output:
## Monitor-PR: blocked
- **PR**: <URL>
- **Reason**: <changes-requested | CI-stuck | fix-pr-budget-exhausted | other>
- **Failing checks**: <list or none>
- **Open bot comments**: <count>
- **Human reviews**: <state>
- **Next step**: <what the user needs to do>
Exit non-clean. Do not merge.
Output:
## Monitor-PR: clean
- **PR**: <URL>
- **Checks**: all passed
- **Bot comments**: addressed
- **fix-pr invocations**: 0 | 1 | 2 | 3
- **Ready to merge**: yes
Caller may now invoke merge-pr. This skill does NOT merge.
development
Restate the last message in plain human language, with no jargon.
testing
Fan out a batch of work items into one PR each via isolated worktree agents, review every PR before it opens, then babysit all PRs through green CI and review feedback. Use when the user wants to fan out PRs, dispatch parallel PR agents over a list of items, or run a batch of independent changes as separate PRs.
development
Dispatch user-visible coding or research agents through Herdr with Codex-Desktop-like thread ergonomics. Use when the user asks to use Herdr to spawn, dispatch, fan out, inspect, follow up with, or monitor agent workspaces/threads.
development
Generate self-contained HTML visualizations with Plannotator theming. Use for implementation plans, PR explainers, architecture diagrams, data tables, slide decks, and any visual explanation of technical concepts. Plans and PR explainers follow Plannotator's prescriptive approach; all other visual content delegates to nicobailon/visual-explainer.