code-review

Analyze code diffs, commits, and pull requests to identify actionable issues.

Updated Jan 20, 2026
One-click install
npx skills add https://github.com/jmmarotta/skills --skill code-review-jmmarotta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-review
Source: https://github.com/jmmarotta/skills/tree/main/skills/code-review
Command: npx skills add https://github.com/jmmarotta/skills --skill code-review-jmmarotta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineering teams review code changes, diffs, and pull requests to surface correctness, integration risk, and design issues early in the development cycle.

Core Features & Use Cases

  • Review mechanics: scope, evidence, prioritization, and actionable findings to guide teams.
  • Evidence-driven analysis: verify issues against code paths, tests, and observable behavior.
  • Collaboration and rollback planning: document findings with context and suggested mitigations; aligns with architecture and testing strategy.

Quick Start

Load a diff or PR and surface a prioritized set of actionable findings with evidence.

Frequently Asked Questions about code-review

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

FAQPage Schema
How do I review a pull request for correctness and integration risk?

Review a pull request by analyzing diffs, commits, and code paths to surface correctness and integration risk. Apply structured review mechanics to prioritize scope, verify evidence against tests, and generate actionable findings with suggested mitigations.

What is the best way to analyze a code diff for safety issues?

Analyzing a code diff for safety issues involves verifying findings against code paths, tests, and observable behavior. You load the diff context to identify scope, apply risk assessment, and document actionable findings aligned with your architecture.

Can I use automated diff analysis for rollback planning?

Yes, diff analysis supports rollback planning by documenting findings with context and suggested mitigations. It evaluates code changes against your testing strategy and architecture to ensure safe integration and provides actionable rollback guidance.

Does code review work with commits and individual diffs or only pull requests?

Code review works with commits, individual diffs, and pull requests. It applies the same evidence-driven analysis across all review scenarios, using code paths and observable behavior to verify findings, prioritize scope, and surface design issues.

Why do I need software-design principles loaded for code verification?

Software-design principles are required as the source of truth for code verification to ensure findings align with your architecture. Loading them provides the necessary context to evaluate code changes, verify evidence, and assess integration risk accurately.

When should I not use automated code review for pull requests?

Avoid automated code review when you lack diff context, tests, or observable behavior to verify findings. Without these inputs and the software-design source of truth, the analysis cannot accurately prioritize scope, assess risk, or generate actionable mitigations.