MichaelVessia

claude-review

Perform a senior-level peer review of staged changes, then implement warranted fixes

MichaelVessia 2 Updated 3mo ago
GitHub

Install

npx skillscat add michaelvessia/nixos-config/claude-review

Install via the SkillsCat registry.

SKILL.md

Workflow

Step 1: Review staged changes

Read the staged diff and git status:

  • git diff --cached
  • git status

Review as a senior engineer. Produce a structured review with:

  1. Critical Issues - bugs, security vulnerabilities, or breaking changes
    that MUST be fixed.
  2. Improvements - concrete suggestions for better code quality, performance,
    or maintainability.
  3. Nitpicks - minor style or preference items (low priority).

Rules:

  • Be specific. Reference exact file paths and lines.
  • Provide code examples for suggested fixes.
  • Do NOT comment on formatting or whitespace.
  • Do NOT suggest adding comments or docblocks unless something is genuinely
    confusing.
  • Respect the project's CLAUDE.md rules and established patterns.
  • Keep the review concise and actionable.

Step 2: Present the review

Display the full review to the user.

Step 3: Implement fixes

After presenting the review, evaluate your own feedback against the project's
patterns:

  • Implement suggestions that are clearly correct improvements (bugs,
    security issues, genuine code quality wins).
  • Skip anything that is purely stylistic preference, overly cautious, or
    conflicts with the project's established conventions.
  • Explain which suggestions you're implementing and which you're skipping
    (and why).

After making changes, re-stage the modified files.