VividKit Crystal clear AI coding
VI
Choose Your Setup Get Started with AgentKit Continue with ClaudeKit Migrate from ClaudeKit to AgentKit Clean cutover from ClaudeKit What Is AgentKit? How AgentKit Works AgentKit Kits, Skills, Agents & Hooks AgentKit Runtime Support AgentKit Desktop App AgentKit Configuration AgentKit CLI Quick Reference AgentKit Skills Cheatsheet AgentKit Workflows AgentKit Statusline Update AgentKit CLI & Kits AgentKit Helper Clean reinstall of AgentKit AgentKit Troubleshooting What is ClaudeKit? ClaudeKit CLI Guide Command Finder Commands Cheat Sheet Workflow Recipes CLI Quick Reference Claude Mechanics Permission Modes ClaudeKit Hooks Coexistence ClaudeKit x Codex CK → Other coding tools How ClaudeKit Works Inside ClaudeKit Finding Your Unknowns Session Recovery Fix from Logs UI/UX Guide Accounts Switcher IDE Config Remote Control Codex App System Diagramming UI Review Gate Promotions Support VividKit

Quick Ref / Command

Engineer Kit

/ak:review-pr

GitHub PR review

Review one or more GitHub PRs for correctness, security, breaking changes, code quality, project rules, tests, and AI-slop, with optional fix, reply, merge, advice, ultra, and REST fallback paths.

01

Parse PR refs

02

Probe GitHub API

03

Resolve context

04

Review thoroughly

Rule 01

Each PR completes end-to-end before the next PR starts

Rule 02

Review severity is evidence-based: Critical, Important, Suggestion

Rule 03

AI-slop is about maintainability damage, not accusing the author

Rule 04

Fix, reply, and merge flags compose but never bypass gates

Execution Map

Core lanes from input to output, aligned with the command's real execution path.

01

Start

Input, scope, route

  1. 1 Parse PR refs Strip mode flags, split bare numbers, #numbers, URLs, spaces, or commas into sequential PR_REFS.
  2. 2 Probe GitHub API Source gh-api helpers, detect GraphQL blockage, and fall back to REST for metadata, diff, files, checks, reviews, and comments.
02

Work

Agent / skill execution

  1. 3 Resolve context For each PR, resolve writing language, validate PR body contract, read metadata, changed files, diff, and CI status.
  2. 4 Review thoroughly Read changed files in context and check correctness, security, breaking changes, project-specific compliance, tests, and anti-slop signals.
03

Verify

Gate, review, validation

  1. 5 Summarize verdict Return summary, risk level, severity-grouped findings, and verdict: Approve, Request changes, or Comment.
  2. 6 Run optional loops If requested, run --ultra initial verifier, --fix through ak:fix plus commit/push, --reply via adaptive review, and --advice checkpoints.
04

Close

Report, handoff, artifact

  1. 7 Merge and watch When `--merge` passes readiness, activate ak:git merge-pr and wait for target-branch CI green, blocker, or exhausted fixes before moving on.
  2. 8 Report aggregate After all PRs, output a per-PR table, environment mode, advisory summary, blockers, and unresolved questions.

Syntax, arguments, subcommands

How to invoke the skill: syntax, positional arguments, shared options, then each subcommand with its own syntax and outcome.

Syntax

/ak:review-pr <PR number or URL> [<PR number or URL> ...] [--fix] [--reply] [--merge] [--advice] [--ultra]

Arguments

<PR number or URL> Required

PR reference

GitHub pull request to review. Use a bare number, #number, or full PR URL; repeat or comma-separate refs to process multiple PRs sequentially.

/ak:review-pr 482

Shared options

--fix

Fix findings

Authorizes the fix loop: repair actionable findings, verify, commit, push, then re-review. It must not include unrelated changes or bypass failed verification.

/ak:review-pr 482 --fix
--reply

Post review

Posts the final review result to GitHub as an approve, request-changes, or comment review. It does not deduplicate earlier replies.

/ak:review-pr 482 --reply
--merge

Merge ready PR

Runs the merge stage after review, fix, and reply stages only when readiness gates pass, then watches target-branch CI. It never forces red checks, conflicts, or branch protection.

/ak:review-pr 482 --fix --reply --merge
--advice

Advisory supervision

Adds kongming checkpoints for verdict, fix scope, review body, merge risk, and CI-green follow-up. Advice cannot override the review or merge gates.

/ak:review-pr 482 --advice
--ultra

Best-of-five review

Runs only the initial review through five read-only candidates and an evidence-checking verifier; later fix-loop re-reviews remain single-pass.

/ak:review-pr 482 --ultra

Modes / Routes

default

Review-only

Research:
Metadata, body, diff, files, checks
Review:
Security findings included
Validate:
Local findings only
--fix

Fix loop

Research:
Re-review after ak:fix
Review:
Fixes Critical/Important first
Validate:
Commits and pushes through ak:git cp
--reply

Post review

Research:
Same review body
Review:
Same findings
Validate:
Uses adaptive GitHub review helper
--merge

Merge ready PR

Research:
Readiness metadata and checks
Review:
No blocker findings
Validate:
Delegates to ak:git merge-pr
--advice

Advisory supervision

Research:
Kongming checkpoints
Review:
Risk sanity checks
Validate:
Does not override gates
--ultra

Best-of-5 initial review

Research:
Five candidate reviews plus verifier
Review:
Security checked by candidates
Validate:
Deduplicated validated findings

Sample Prompt

Concrete invocations for each flag, subcommand, mode, or route available in the live workflow.

Review a PR locally Recommended 
/ak:review-pr 123
Use when:
Use when you need a thorough PR review by number or URL without editing, posting, or merging.
Expected:
The skill resolves language and PR context, validates the PR body, reads metadata, diff, changed files, checks, then returns summary, risk, findings by severity, and verdict.
Fix findings and post 
/ak:review-pr 123 --fix --reply
Use when:
Use when you are allowed to remediate actionable review findings and post the final review to GitHub.
Expected:
After review, actionable Critical/Important findings go through ak:fix, verified fixes are committed and pushed with ak:git cp, then only the final re-review is posted or printed locally on fallback.
Review and merge multiple PRs 
/ak:review-pr 123 456 --reply --merge
Use when:
Use when several PR refs should be processed sequentially with a posted review and merge attempt for each ready PR.
Expected:
Each PR completes its full review, reply, merge-readiness gate, ak:git merge-pr handoff, and target-branch CI watch before the next PR starts; final output includes the per-PR table.
Ultra review with advice 
/ak:review-pr 789 --ultra --advice
Use when:
Use for a higher-assurance review where the initial pass should use five read-only candidates plus a verifier and kongming checkpoints.
Expected:
The initial review is built from an evidence-validated union of five candidate reviews, then advisory checkpoints can sanity-check verdicts, fix scope, reply body, merge risk, and CI-green follow-up.

Handled Scope

  • Parse PR refs
  • Probe GitHub API
  • Resolve context
  • Review thoroughly
  • Summarize verdict
  • Run optional loops

Artifacts Produced

PR review output

Pattern

Chat review plus optional GitHub review/comment; final per-PR table for multi-PR runs

Includes summary, risk level, severity-grouped findings, verdict, environment fallback, merge or CI state, and unresolved questions.

Next