From smooth-ai-review
Analyze and execute AI PR review feedback with fix/skip decisions. Use when a user asks to parse an AI review, apply selected fixes, and finalize review processing for GitHub or Azure DevOps pull requests. Detects the review source — for a GitHub Copilot agent review it replies to and resolves each linked review thread; otherwise it appends AI review notes to the PR description.
How this skill is triggered — by the user, by Claude, or both
Slash command
/smooth-ai-review:ai-reviewThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Analyze AI PR review feedback and execute fix/skip decisions.
Analyze AI PR review feedback and execute fix/skip decisions.
Script location. Every
.agents/skills/ai-review/...path in this document assumes the skill is installed in the repository (copy-install or this repo itself). When this skill runs from the Claude Code plugin (smooth-ai-review), the repository has no.agents/skills/ai-reviewtree — substitute${CLAUDE_PLUGIN_ROOT}/.agents/skills/ai-reviewfor.agents/skills/ai-reviewin every script invocation (e.g."${CLAUDE_PLUGIN_ROOT}/.agents/skills/ai-review/scripts/copilot-review.sh" detect <pr>).
The skill is invoked as /ai-review <args>.
Mode selection:
analyse or execute.\d+=(fix|skip) → execute mode.Examples:
/ai-review 48 # auto → analyse
/ai-review analyse 48 # explicit analyse
/ai-review 48 1=fix 2=skip # auto → execute
/ai-review execute 48 1=fix 2=skip # explicit execute
Review source selection (GitHub):
The skill must determine whether the review being processed is a GitHub Copilot agent review or a review from another source (e.g. an OpenCode CLI agent, Gemini, or a generic AI reviewer). The source decides where execute results land — see Execute → Result routing.
--source=copilot or --source=other..agents/skills/ai-review/scripts/copilot-review.sh detect <pr> # prints COPILOT or OTHER
It scans the PR's reviews and inline review comments for the Copilot reviewer bot (login Copilot / copilot-pull-request-reviewer[bot]). COPILOT → Copilot flow; OTHER → other.GitHub plumbing lives in
scripts/copilot-review.sh. All deterministic GitHub calls (detect, fetch threads, reply, resolve, post summary) are subcommands of that script. The skill keeps the judgment — parsing the review, fix/skip decisions, and the text of every reply/summary. Reply and summary bodies are piped to the script via STDIN, so multi-line markdown is safe.
Examples:
/ai-review 48 # analyse, auto-detect source
/ai-review analyse 48 --source=copilot # force Copilot-review parsing
/ai-review execute 48 1=fix 2=skip # execute, source auto-detected
/ai-review execute 48 1=fix --source=other # force non-Copilot result routing
analyse and executeUse when: User provides review URL, review ID, or just PR number
Workflow:
Resolve PR number and review ID from arguments
Detect review source (Copilot vs other) per Review source selection
Fetch review body using gh api or az repos pr CLI
.agents/skills/ai-review/scripts/copilot-review.sh threads <pr>
Returns JSON nodes of { id, isResolved, comments:[{ databaseId, path, author, body }] }.Parse the review to extract issues and suggested fixes. Copilot flow: record, per issue, the Copilot inline comment databaseId and its enclosing review thread id (from the threads output) so execute can reply and resolve the correct thread.
Determine recommendation for each issue:
skipskipfixfixskipfixOutput analysis table (the detected source is stated above the table):
| # | File | AI PR Review Recommendation | Priority | AI Coder Recommendation | AI Reviewer Reasoning |
|---|
For the Copilot flow, retain the commentId / threadId mapping per row (used by execute) — it need not be printed in the table.
Print summary and suggested next command
STOP — Do NOT proceed to execute automatically. User decides whether and how to run execute.
Use when: User provides decisions from analyse output
Argument format: <pr-number> <1=fix|skip> <2=fix|skip> ...
Workflow:
/ai-review marker re-triggers a full review run, which is only warranted to re-verify critical/high findings). For reviews with only medium/low findings, do NOT make this commit — the fix commits from step 3 suffice.The detected review source decides where the fix/skip summary table and analysis are posted.
Copilot flow (--source=copilot or auto-detected Copilot review):
fix and skip — reply to the linked Copilot inline review comment with that row's decision and reasoning, then mark its review thread resolved:
printf '%s' "**ai-review: FIX** — <what changed / commit ref>" \
| .agents/skills/ai-review/scripts/copilot-review.sh reply <pr> <commentId> # SKIP + reasoning for skipped rows
.agents/skills/ai-review/scripts/copilot-review.sh resolve <threadId>
commentId/threadId (e.g. it came from the Copilot summary, not an inline comment), skip the per-thread step for that row and rely on the summary comment below.cat summary.md | .agents/skills/ai-review/scripts/copilot-review.sh summary <pr>
Non-Copilot flow (--source=other or any non-Copilot review):
ci: /ai-review … empty marker commit when the review had critical/high findings — never for medium/low-only reviewsnpx claudepluginhub generic-automation-and-it/smooth-ai-report-review --plugin smooth-ai-reviewProvides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.