code-review-and-quality

Review code changes for correctness, readability, architecture, security, and performance.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/pyoclaw/agent-skills --skill code-review-and-quality-pyoclaw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-review-and-quality
Source: https://github.com/pyoclaw/agent-skills/tree/main/skills/code-review-and-quality
Command: npx skills add https://github.com/pyoclaw/agent-skills --skill code-review-and-quality-pyoclaw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a consistent, multi-dimensional review process that prevents low-quality, insecure, or unverified changes from entering the main branch by evaluating correctness, readability, architecture, security, and performance before merge.

Core Features & Use Cases

  • Five-axis evaluation: Systematically assess correctness, readability & simplicity, architecture, security, and performance for every change.
  • Review workflow: Guidance on reviewing tests first, walking code with a checklist, categorizing findings by severity, and validating the verification story.
  • Change sizing & process: Recommendations for acceptable change sizes, splitting strategies, and dependency discipline to reduce review friction.
  • Use case: Run this Skill on pull requests, refactors, bug fixes, or agent-generated code to produce actionable, prioritized feedback and a clear approval decision.

Quick Start

Request a multi-axis review by providing the PR diff or changed files and asking for findings on correctness, readability, architecture, security, and performance.

Frequently Asked Questions about code-review-and-quality

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

FAQPage Schema
How do I perform a multi-axis code review on a pull request?

Multi-axis code review evaluates pull request diffs across correctness, readability, architecture, security, and performance. You provide the changed files and request findings to receive severity-classified feedback and actionable fixes before merging.

What is the best way to review AI-generated code before merging?

Reviewing AI-generated code requires validating the verification story across five axes: correctness, readability, architecture, security, and performance. Apply a systematic checklist to the diff to classify findings by severity and ensure safer merges.

How do I classify code review findings by severity during a refactor?

Classify code review findings by severity by walking the refactor diff with a checklist covering correctness, architecture, and security. This categorization produces prioritized, actionable feedback for the verification story.

Can I use multi-axis code review for large refactors and bug fixes?

Yes, multi-axis code review applies to refactors and bug fixes by assessing change sizes and dependency discipline. It guides splitting strategies to reduce review friction and validate the overall verification story before merge.

How does evaluating the verification story improve code quality?

Evaluating the verification story improves code quality by checking tests and specifications against the diff. This prevents unverified changes from entering the main branch by ensuring correctness and performance standards are met.

What security and performance checks should I run before a merge?

Before a merge, run security and performance checks as part of a five-axis evaluation covering correctness, readability, architecture, security, and performance. This systematic assessment identifies vulnerabilities and bottlenecks in the changed files.