self-review

Reviews uncommitted git changes and outputs a structured markdown code review.

Updated May 23, 2026
One-click install
npx skills add https://github.com/kveperedo/website --skill self-review-kveperedo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: self-review
Source: https://github.com/kveperedo/website/tree/main/.agents/skills/self-review
Command: npx skills add https://github.com/kveperedo/website --skill self-review-kveperedo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Getting fast, thorough feedback on local code changes before pushing or opening a pull request is hard without a second reviewer. This Skill inspects your uncommitted or unpushed git changes and produces a structured, copy-paste-ready code review covering code quality, design system compliance, security, and test coverage. ## Core Features & Use Cases - Flexible Diff Scoping: Reviews staged changes, unstaged changes, branch-vs-main diffs, or specific commit ranges based on what you ask. - Multi-Perspective Review: Delegates to four specialized reviewers covering clean code, design system consistency, security vulnerabilities, and E2E test coverage. - Structured Output: Consolidates findings into a deduplicated markdown review grouped by file, with severity labels (Bug, Suggestion, Nit, Security, Design) and a clear verdict. - Use Case: Before pushing a feature branch, ask for a review of your changes and receive a file-by-file critique with concrete fix suggestions, including whether new routes or server functions need Playwright E2E coverage. ## Quick Start Ask the assistant to review my current uncommitted changes and give me a structured code review.

Frequently Asked Questions about self-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review my uncommitted changes before pushing?▼

Run a self-review on your local changes by asking for a review of the current diff. The Skill defaults to git diff HEAD, which captures all staged and unstaged changes, then returns a structured markdown review grouped by file with severity labels.

How to review a branch diff against main before a pull request?▼

Specify the base branch when requesting the review, and the Skill uses git diff main..HEAD or origin/main..HEAD to scope the comparison. It reads the full changed files for context, not just the diff, before producing findings.

What does the code review output format look like?▼

The review starts with a verdict (Approved, Approved with suggestions, or Changes requested), then groups numbered findings by file. Each finding has a severity label such as Bug, Suggestion, Nit, Security, or Design, plus a code snippet and a concrete fix suggestion.

Does the review check for security vulnerabilities?▼

Yes, a dedicated security pass examines the diff for unvalidated input, injection risks, exposed secrets, missing auth checks, unsafe use of user-controlled data, session handling, and database query safety.

Can it review staged changes only instead of everything?▼

Yes, when you ask to review only staged changes, the Skill scopes the diff with git diff --cached. It also supports specific commit ranges using git diff <from>..<to> when you provide explicit refs.

Does the review check Playwright E2E test coverage?▼

Yes, staged spec files are audited against Playwright conventions such as accessible locators, hydration-aware navigation, and try/finally cleanup. If no specs are staged, it assesses whether changed routes or server functions need new E2E tests and suggests concrete cases.