review

Evaluate code and plans against approved requirements with categorized findings.

2|Updated May 5, 2026
One-click install
npx skills add https://github.com/OrestesK/pi --skill review-orestesk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review
Source: https://github.com/OrestesK/pi/tree/main/skills/review
Command: npx skills add https://github.com/OrestesK/pi --skill review-orestesk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents superficial approvals by providing a structured, evidence-based way to evaluate plans, implementations, and review feedback against requirements and project standards.

Core Features & Use Cases

  • Spec Compliance Reviews: Verify that implementations match approved behavior, constraints, scope, and proof requirements.
  • Code Quality Reviews: Identify correctness, maintainability, security, testing, error-handling, and structural issues supported by concrete evidence.
  • Plan and Feedback Evaluation: Assess implementation plans for feasibility and classify review feedback as must-fix, should-fix, nit, note, or needs-discussion.
  • Use Case: After a non-trivial implementation, use this Skill to inspect the effective diff, select distinct evidence targets, validate findings, and synthesize a defensible readiness decision.

Quick Start

Ask the review skill to evaluate the current implementation against the approved requirements and return categorized findings with file paths, line numbers, impact, fixes, and supporting evidence.

Frequently Asked Questions about review

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

FAQPage Schema
How do I perform an evidence-based code review against approved requirements?

To perform an evidence-based code review, evaluate implementations against approved requirements by inspecting the effective diff, selecting evidence targets, validating findings, and reporting categorized conclusions with file paths and line numbers.

What is spec compliance assessment in software engineering?

Spec compliance assessment verifies that implementations match approved behavior, constraints, scope, and proof requirements. It ensures code adheres to project standards by validating findings against concrete evidence rather than superficial approvals.

How do I classify review feedback into must-fix, should-fix, and nit categories?

To classify review feedback, evaluate implementation feedback against project standards to categorize findings as must-fix, should-fix, nit, note, or needs-discussion. This structured approach prevents superficial approvals by prioritizing actionable items.

How do I validate implementation readiness before deployment?

Validate implementation readiness by inspecting relevant changes, selecting appropriate review modes, validating findings, and synthesizing a defensible readiness decision. This checks code correctness, maintainability, security, and error-handling with concrete evidence.

Does automated plan validation prevent scope expansion during code reviews?

Yes, plan validation prevents scope expansion by assessing implementation plans for feasibility and reporting categorized conclusions without expanding scope. It ensures reviews stay focused on approved requirements and project standards.

What is the best way to audit code quality without guesswork?

The best way to audit code quality is to inspect the effective diff, select distinct evidence targets, and validate findings supported by concrete evidence. This identifies correctness, maintainability, and structural issues while preventing superficial approvals.