review_skill

Overview

This skill provides an interactive web-based markdown review UI that lets you approve, reject, and comment on individual items. It opens a browser window so you can check boxes, add notes, and submit structured feedback. Use it when you want a quick, collaborative pass over plans, docs, or code snippets.

How this skill works

The skill determines the content source from a file path, direct input, or recent conversation context, then launches the review UI by calling mcp__interactive_review__start_review. You interact with items via checkboxes and optional comments; when you submit, the tool returns a JSON summary of approvals and rejections. I parse that JSON and present a concise review summary and next-step options.

When to use it

• You say: "review this", "check this plan", or provide a file path to review
• You need line-item approvals or rejections with comments
• You want an interactive, browser-based review session for markdown content
• You prefer structured feedback (approved / needs revision) you can act on programmatically
• You want to turn conversational content into a formal review quickly

Best practices

• If reviewing a file, provide the explicit file path so the tool reads the correct source
• Give a clear title or context to help reviewers focus on the right scope
• Break large documents into sections before review to keep item lists manageable
• Encourage reviewers to add short, actionable comments for any rejected item
• After submission, decide whether to proceed with approved items or request revisions immediately

Example use cases

• Review an implementation plan extracted from chat and get item-by-item approvals
• Open a README.md or design doc for checklist-style review with comments
• Quickly validate a release checklist or deployment plan with stakeholders
• Collect structured feedback on a proposed API spec or feature list
• Iteratively revise rejected items and then re-run the review