inbox
npx machina-cli add skill technicalpickles/pickled-claude-plugins/inbox --openclawGit Inbox
Overview
Show PRs awaiting your review across repositories. Surfaces what needs your attention with context to prioritize.
Announce: "Using git:inbox to check PRs awaiting your review..."
When to Use
- Starting your day - "what needs my attention?"
- User asks about PRs to review
- User says "inbox", "review queue", "what's waiting on me?"
Workflow
1. Fetch PRs Awaiting Review
# PRs where you're requested reviewer
gh search prs --review-requested=@me --state=open --json repository,number,title,author,createdAt,url
# PRs where you're assigned
gh search prs --assignee=@me --state=open --json repository,number,title,author,createdAt,url
2. Enrich with Review Status
For each PR, get review state:
gh pr view {number} --repo {owner}/{repo} --json reviews,reviewRequests
3. Present Inbox
Format as actionable list:
## PRs Awaiting Your Review
### {repo} #{number}: {title}
- **Author:** @{author}
- **Age:** {days} days
- **URL:** {full_url}
- **Status:** {review_status}
---
{N} PRs need your attention. Check out a PR for local review?
Important:
- Always show full PR URL (clickable/copy-pasteable)
- Sort by age (oldest first) or priority
- Show review status (no reviews yet, changes requested, approved by others)
4. Offer Next Action
Use AskUserQuestion:
Which PR would you like to check out for review?
(A) #{number} - {title}
(B) #{number} - {title}
(C) #{number} - {title}
(D) None right now
If user picks one → invoke git:checkout with the PR.
Quick Reference
| Command | Purpose |
|---|---|
gh search prs --review-requested=@me --state=open | PRs requesting your review |
gh pr view {n} --repo {r} --json reviews | Get review status |
Related
git:checkout- Check out a PR for local reviewcode-review- Guide the actual review process (separate skill)
Source
git clone https://github.com/technicalpickles/pickled-claude-plugins/blob/main/plugins/git/skills/inbox/SKILL.mdView on GitHub Overview
Git Inbox surfaces PRs awaiting your review across repositories. It helps you prioritize what needs attention by presenting context to act quickly, whether you are starting your day or handling incoming review requests.
How This Skill Works
Fetch PRs awaiting your review (review requested or assigned) using gh search prs. Enrich each PR with its current review status via gh pr view to show no reviews yet, changes requested, or approved. Present the list as an actionable inbox with full PR URLs, sorted by age or priority, and prompt you for the next action.
When to Use It
- Starting your day to see what needs attention
- Answering a user request for PRs to review
- You say inbox, review queue, or what's waiting on me
- Prioritizing reviews by age or priority
- New review requests or assignments arrive and you want a quick surface
Quick Start
- Step 1: Fetch PRs awaiting your review with gh search prs --review-requested=@me --state=open --json repository,number,title,author,createdAt,url
- Step 2: Enrich each PR with review status using gh pr view {number} --repo {owner}/{repo} --json reviews,reviewRequests
- Step 3: Present the inbox as an actionable list and prompt for the next action
Best Practices
- Sort results by age (oldest first) or by priority to highlight critical reviews
- Always display the full PR URL for easy access
- Show current review status (no reviews yet, changes requested, approved by others)
- Use the fetch then enrich workflow to keep data fresh
- Double-check repository scope and filters (review-requested=@me, assignee=@me)
Example Use Cases
- You start the day by running inbox to surface open PRs waiting for your review
- A teammate asks for PRs to review and inbox returns a prioritized list with titles and authors
- A high priority PR shows changes requested and is surfaced for immediate action
- You select a PR from the inbox and proceed to checkout for local review
- You open a PR URL directly from the inbox to review in the browser
