Agent skill

pr-poll

Manages PR review polling daemon for automatic notifications and auto-respond.

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/goffity/claude-km-skill/tree/main/skills/pr-poll

SKILL.md

PR Poll - Automatic PR Review Notifications

จัดการ polling daemon ที่ตรวจสอบ PR reviews และส่ง notification อัตโนมัติ

Usage

/pr-poll              # Show status
/pr-poll start        # Start daemon (notification only)
/pr-poll auto         # Start daemon with auto-respond (Claude handles reviews)
/pr-poll stop         # Stop daemon
/pr-poll check        # Check once (no daemon)

Instructions

Step 1: Parse Command

ถ้าไม่มี argument หรือ status: → แสดงสถานะ daemon

ถ้า start: → Start daemon (notification only)

ถ้า auto: → Start daemon with auto-respond (Claude handles reviews automatically)

ถ้า stop: → Stop daemon

ถ้า check: → Run once and exit

Step 2: Execute Action

Status (default)

bash
./scripts/pr-review-poll-status.sh

Output:

  • Daemon status (running/stopped)
  • Tracked PRs
  • Last log entries

Start Daemon (Notification Only)

bash
./scripts/pr-review-poll-start.sh --interval 300

Options:

  • --interval N - Polling interval in seconds (default: 300 = 5 minutes)
  • --repo OWNER/REPO - Specific repo to monitor

Output:

Daemon started (PID: 12345)

Log file: ~/.pr-review-poll.log
To view logs: tail -f ~/.pr-review-poll.log
To stop: ./pr-review-poll-stop.sh

Start Daemon with Auto-Respond

bash
# Get current working directory
WORKING_DIR=$(pwd)

# Start with auto-respond enabled
./scripts/pr-review-poll-start.sh --interval 300 --auto-respond --working-dir "$WORKING_DIR"

Options:

  • --auto-respond - Enable automatic Claude CLI spawning
  • --working-dir DIR - Working directory for Claude (required with --auto-respond)

Output:

Daemon started (PID: 12345)
Auto-respond: ENABLED
Working dir: /path/to/repo

Log file: ~/.pr-review-poll.log
To view logs: tail -f ~/.pr-review-poll.log
To stop: ./pr-review-poll-stop.sh

How Auto-Respond Works:

  1. Daemon detects new PR review
  2. Spawns Claude CLI with /pr-review prompt
  3. Claude analyzes and responds to review feedback
  4. Log file created: ~/.pr-review-claude-{pr}-{timestamp}.log

Important Notes:

  • Requires claude CLI to be installed and in PATH
  • Uses --dangerously-skip-permissions for non-interactive execution
  • Each Claude session runs in background with separate log file

Stop Daemon

bash
./scripts/pr-review-poll-stop.sh

Output:

Daemon stopped

Check Once

bash
./scripts/pr-review-poll.sh --once

Output:

  • Lists checked PRs
  • Sends notifications for new reviews

Step 3: Display Summary

markdown
## PR Poll Status

| Metric | Value |
|--------|-------|
| Status | Running / Stopped |
| PID | [pid] |
| Interval | [seconds]s |
| Tracked PRs | [count] |

### Recent Activity
[last 5 log lines]

### Commands
- Start: `/pr-poll start`
- Stop: `/pr-poll stop`
- Check now: `/pr-poll check`

How It Works

  1. Polling: Daemon checks GitHub every N seconds for user's open PRs
  2. Detection: Compares current reviews with stored state
  3. Notification: Sends macOS notification for new reviews
  4. Action: Notification suggests running /pr-review

Notification Types

Review State Sound Message
APPROVED Glass "Approved by @reviewer"
CHANGES_REQUESTED Basso "Changes requested by @reviewer"
COMMENTED Ping "@reviewer left a comment"

Files

File Purpose
~/.pr-review-poll.pid Daemon PID file
~/.pr-review-poll.log Daemon log file
~/.pr-review-state.json PR review state

Examples

bash
# Start daemon with 5-minute interval (default, notification only)
/pr-poll start

# Start with auto-respond - Claude handles reviews automatically
/pr-poll auto

# Start with 1-minute interval for active development
./scripts/pr-review-poll-start.sh --interval 60

# Auto-respond with 1-minute interval
./scripts/pr-review-poll-start.sh --interval 60 --auto-respond --working-dir "$(pwd)"

# Monitor specific repo with auto-respond
./scripts/pr-review-poll-start.sh --repo owner/repo --auto-respond --working-dir /path/to/repo

# Quick check without starting daemon
/pr-poll check

Troubleshooting

Issue Solution
Daemon not starting Check gh auth status
No notifications Check macOS notification settings
Too many notifications Increase poll interval
Stale state Delete ~/.pr-review-state.json

Related Commands

Command Purpose
/pr-review Handle PR review feedback
/pr Create PR
/focus Set current task

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

goffity/claude-km-skill

commit

Creates atomic commits by invoking TDG and commenting on related GitHub issues.

0 0
Explore
goffity/claude-km-skill

distill

Synthesizes related learnings into reusable knowledge base patterns.

0 0
Explore
goffity/claude-km-skill

security-auditor

Audits code for security vulnerabilities including OWASP Top 10 and authentication issues.

0 0
Explore
goffity/claude-km-skill

code-reviewer

Reviews code changes for bugs, security vulnerabilities, and performance issues.

0 0
Explore
goffity/claude-km-skill

example

Saves reusable code examples to the examples library with metadata and tags.

0 0
Explore
goffity/claude-km-skill

flow

Documents workflow diagrams and process flows with Mermaid diagram support.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results