Search

PythonReactSEOPDF
GitHub Skill

vrau-reviewer

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

mguilarducci☆ 1 Repository stars0 Repository forks

Installation

Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.

View source ↗Guides

Skill instructions

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

Examples

Read the usage examples in the source repository.

View source ↗

Source history

Indexed on
2026-01-20
Index updated
2026-01-26
Branch
main

Index and sync dates describe this directory. View the source repository for code history.

GitHub ↗

chat Comments (0)

chat_bubble_outline

No comments yet. Be the first to share your thoughts!