Menu
Poll GitHub PR for review feedback, auto-fix issues, and report terminal state
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/diegosouzapw/awesome-omni-skill --skill pr-watchThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Token-efficient tracking for AI orchestration. CLI-first for status updates (~50 tokens), agent fallback for complex ops (~1KB). Use when: updating task status, querying blockers, creating progress files, validating phases.
AshAi extension guidelines for integrating AI capabilities with Ash Framework. Use when implementing vectorization/embeddings, exposing Ash actions as LLM tools, creating prompt-backed actions, or setting up MCP servers. Covers semantic search, LangChain integration, and structured outputs.
This skill should be used when solving hard questions, complex architectural problems, or debugging issues that benefit from GPT-5 Pro or GPT-5.1 thinking models with large file context. Use when standard Claude analysis needs deeper reasoning or extended context windows.
Based on SOC occupation classification
| name | pr-watch |
| description | Poll GitHub PR for review feedback, auto-fix issues, and report terminal state |
| version | 1.0.0 |
| category | workflow |
| tags | ["pr","github","review","automation","polling"] |
| author | OmniClaude Team |
| composable | true |
| inputs | [{"name":"pr_number","type":"int","description":"GitHub PR number to watch","required":true},{"name":"repo","type":"str","description":"GitHub repo slug (org/repo)","required":true},{"name":"timeout_hours","type":"float","description":"Max hours to wait for review (default 24)","required":false},{"name":"max_review_cycles","type":"int","description":"Max auto-fix cycles before escalating (default 3)","required":false},{"name":"auto_fix","type":"bool","description":"Auto-fix Critical/Major/Minor review comments (default true)","required":false},{"name":"fix_nits","type":"bool","description":"Also auto-fix Nit-level comments (default false)","required":false}] |
| outputs | [{"name":"skill_result","type":"ModelSkillResult","description":"Written to ~/.claude/skill-results/{context_id}/pr-watch.json","fields":[{"status":"approved | changes_requested_fixed | timeout | capped | error"},{"pr_number":"int"},{"repo":"str"},{"fix_cycles_used":"int"},{"elapsed_hours":"float"}]}] |
| args | [{"name":"pr_number","description":"GitHub PR number to watch","required":true},{"name":"repo","description":"GitHub repo slug (org/repo)","required":true},{"name":"--timeout-hours","description":"Max hours to wait for review (default 24)","required":false},{"name":"--max-review-cycles","description":"Max fix cycles before escalating (default 3)","required":false},{"name":"--no-auto-fix","description":"Poll only, don't attempt fixes","required":false},{"name":"--fix-nits","description":"Also auto-fix Nit-level comments","required":false}] |
Poll GitHub PR review status. Auto-fix review comments (Critical/Major/Minor by default) using
pr-review-dev. Exit when PR reaches a terminal state: approved, changes_requested_fixed
(all blocking issues resolved), timeout, or capped (max fix cycles reached).
Announce at start: "I'm using the pr-watch skill to monitor reviews for PR #{pr_number}."
Implements: OMN-2524
/pr-watch 123 org/repo
/pr-watch 123 org/repo --timeout-hours 48
/pr-watch 123 org/repo --max-review-cycles 5
/pr-watch 123 org/repo --fix-nits
/pr-watch 123 org/repo --no-auto-fix
gh pr view {pr_number} --repo {repo} --json reviews,reviewDecisionreviewDecision == APPROVED: exit with status: approvedreviewDecision == CHANGES_REQUESTED and auto_fix=true and cycles remaining:
status: cappedstatus: timeoutstatus: changes_requested_fixedTask(
subagent_type="onex:polymorphic-agent",
description="pr-watch: fix review comments for PR #{pr_number} (cycle {N})",
prompt="Invoke: Skill(skill=\"pr-review-dev\", args=\"{pr_number}\")
Review comments:
{review_comments}
Fix all Critical, Major, and Minor issues.{nit_instruction}
Push fixes to branch: {branch_name}
Report: issues fixed, files changed, any issues skipped."
)
Write ModelSkillResult to ~/.claude/skill-results/{context_id}/pr-watch.json on exit.
{
"skill": "pr-watch",
"status":
Status values: approved | changes_requested_fixed | timeout | capped | error
pr-watch supports two notification modes, selected automatically based on infrastructure availability. The push-based mode eliminates polling for CI status checks during the review cycle.
When Kafka and Valkey are available (ENABLE_REAL_TIME_EVENTS=true):
(repo, pr_number) via Valkey watch registrypr-status event arrives in the agent's inbox topic
(onex.evt.omniclaude.agent-inbox.{agent_id}.v1)from omniclaude.services.inbox_wait import register_watch, wait_for_pr_status
# Register watch for CI re-runs after pushing fixes
await register_watch(agent_id=agent_id, repo=repo, pr_number=pr_number)
# After pushing a fix, wait for CI to complete (replaces polling)
ci_result = wait_for_pr_status(
repo=repo,
pr_number=pr_number,
run_id=latest_run_id,
agent_id=agent_id,
timeout_seconds=3600,
)
When Kafka/Valkey are unavailable:
gh run watch {run_id} --exit-status as background process after pushing fixes~/.claude/pr-inbox/)from omniclaude.services.inbox_wait import wait_for_pr_status
# Unified interface -- automatically falls back to STANDALONE
ci_result = wait_for_pr_status(
repo=repo,
pr_number=pr_number,
run_id=latest_run_id,
timeout_seconds=3600,
)
The original review polling loop is unchanged. The inbox-wait pattern replaces only the
CI status checks that happen between fix cycles (when pr-watch pushes a fix and needs
to wait for CI before re-requesting review). The wait_for_pr_status() function provides
a unified interface that works in both EVENT_BUS and STANDALONE modes.
ticket-pipeline skill (planned: invokes pr-watch after ci-watch passes)ci-watch skill (planned: runs before pr-watch)auto-merge skill (planned: runs after pr-watch passes)pr-review-dev skill (invoked to fix review comments)inbox_wait module (omniclaude.services.inbox_wait) — unified wait interfacenode_github_pr_watcher_effect — ONEX node for EVENT_BUS+ mode routing