skills.rest
honerlaw
honerlawCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

review

Review local diffs for design compliance and code quality issues.

Updated May 16, 2026
Search Tags:#diff analysis#code review#spec compliance#GitHub PR#minerva#triage workflow#knowledge audit
One-click install
npx skills add https://github.com/honerlaw/agent-marketplace --skill review-honerlaw
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review
Source: https://github.com/honerlaw/agent-marketplace/tree/main/plugins/minerva/skills/review
Command: npx skills add https://github.com/honerlaw/agent-marketplace --skill review-honerlaw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you verify that a shipped or in-progress changeset matches the intended design while also catching issues that degrade code quality.

Core Features & Use Cases

  • Design compliance review (minerva context): Compares the diff against proposal.md, the chronological replan.md history, and durable invariants in .minerva/knowledge/ to detect scope drift, missing promised success criteria, and knowledge violations.
  • Code quality review (always): Reviews the same resolved diff for bugs and obvious quality problems, using PR-driven review when an open GitHub PR exists or a structured inline check when it does not.
  • Triage with persistence: Presents findings in numbered sections, lets the user choose FIX/SUGGEST/IGNORE, and persists triage state to scratchpad.md under ## Review triage YYYY-MM-DD so reruns resume with pre-filled dispositions.

Quick Start

Run minerva:review to audit the active changeset for both spec fidelity and code quality and triage the results.

Frequently Asked Questions about review

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

FAQPage Schema
How do I review a code diff for spec compliance and code quality?▼

To review a diff for spec compliance and quality, resolve the target work unit, run a spec and knowledge audit, execute a code-quality check, and number findings for unified triage.

Can I use GitHub PR review to check code quality on an open pull request?▼

Yes, you can use GitHub PR review to check code quality. When an open PR exists, the review process optionally delegates the code-quality pass directly to the GitHub PR workflow.

How does spec compliance review work with minerva context?▼

Spec compliance review works by comparing the diff against proposal.md, replan.md history, and durable invariants in .minerva/knowledge/ to detect scope drift and knowledge violations.

What is the best way to triage code review findings and persist dispositions?▼

The best way to triage findings is to present them in numbered sections, choose FIX/SUGGEST/IGNORE, and persist dispositions in scratchpad.md to enable resumability across reruns.

Do I need minerva work context to audit changes for design fit?▼

No, you do not need minerva work context to audit changes. The review applies to local diffs with or without existing minerva context, always running the code-quality pass.

Related Skills

Explore More Software Engineering Skills→
honerlawhonerlaw

work

Resume and execute minerva work units from proposal and replan history.

Community
Advanced
mindroom-aimindroom-ai
232

address-pr-review-comments

Analyze and categorize GitHub PR review comments for triage and remediation.

Official
Intermediate
honerlawhonerlaw

promote

Promote scratchpad entries into Minerva knowledge while preventing duplicate promotions.

Community
Advanced
microsoftmicrosoft
6.2k

code-review

Review GitHub pull requests for bugs, security issues, and correctness regressions.

Official
Advanced