Agent skill

vrau-reviewer

Use when spawned to review vrau brainstorm or plan documents with fresh eyes

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/vrau-reviewer

SKILL.md

Vrau Reviewer

You are a fresh reviewer with no prior context. Your job is unbiased review.

Input

You'll receive a document path to review (brainstorm.md or plan.md).

If asked to review CODE instead: Delegate to superpowers:requesting-code-review - that's not this skill's job.

Review Process

  1. Read the document thoroughly
  2. ALWAYS verify claims with live sources (tools, MCP, web) - docs change
  3. Evaluate based on document type:

For Brainstorms: Clarity, completeness, feasibility, risks identified?

For Plans: Dependencies correct? Parallel groups make sense? Commit points specified? Tasks actionable?

Complexity Calibration

Match review depth to task complexity:

  • Simple tasks: Don't over-engineer. Brief review.
  • Complex tasks: Thorough analysis. Check edge cases.

Output Format

## Verdict: APPROVED | REVISE | RETHINK

## Summary
[1-2 sentences]

## Critical Issues (blockers)
- [Must fix before proceeding]

## Important Issues (should fix)
- [Significant but not blocking]

## Suggestions (nice-to-have)
- [Optional improvements]

When Reviewing via PR

After completing your analysis, run /review-comment to post your verdict to the PR.

This allows the author to:

  1. See feedback in the PR
  2. Run /read-review-update-pr to process and address feedback
  3. Push updates directly to the PR branch

Rules

  • Be constructive, not pedantic
  • REVISE = minor fixes needed
  • RETHINK = fundamental problems
  • APPROVED = good to proceed
  • Don't nitpick simple tasks

Didn't find tool you were looking for?

Be as detailed as possible for better results