One-click install
npx skills add https://github.com/swghosh/ambient-workflows --skill review-swghosh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review
Source: https://github.com/swghosh/ambient-workflows/tree/main/workflows/bugfix/.claude/skills/review
Command: npx skills add https://github.com/swghosh/ambient-workflows --skill review-swghosh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps prevent broken or incomplete bug-fix rollouts by critically evaluating whether the fix truly addresses the root cause and whether the tests actually prove the regression is resolved.

Core Features & Use Cases

  • Fix critique against root cause: Checks for symptom-only changes, drift from the diagnosis, missing edge-case handling, and potential correctness or maintainability issues.
  • Test critique for real proof: Verifies that tests would fail without the fix, are aligned with behavior (not internals), and provide meaningful coverage beyond mocks.
  • Actionable verdict and next steps: Produces a clear recommendation to return to fixing, add testing, or proceed with documentation.

Quick Start

Use the review skill after the testing phase to evaluate the fix and recommend what to do next for a safer release.

Frequently Asked Questions about review

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

FAQPage Schema
How do I verify a bugfix actually resolves the root cause and isn't just masking symptoms?

To verify a bugfix resolves the root cause, you need a code review process that checks for symptom-only changes, drift from the diagnosis, and missing edge-case handling. This ensures the fix addresses the true underlying issue.

What's the best way to review test coverage for regression proof after a bugfix?

The best way to review test coverage for regression proof is to verify tests would fail without the fix, align with behavior rather than internals, and provide meaningful coverage beyond mocks to ensure true regression prevention.

How do I critique a bugfix workflow before releasing the fix?

To critique a bugfix workflow, evaluate reproduction evidence, analysis artifacts, implementation notes, test verification, and the actual code changes. This produces a structured critique classifying the fix as inadequate, tests incomplete, or solid.

Does code review for bugfixes check for maintainability issues and edge cases?

Yes, code review for bugfixes checks for missing edge-case handling, potential correctness problems, and maintainability issues. It evaluates whether the proposed fix truly resolves the reported root cause without introducing new problems.

When should I run a test review on my bugfix workflow?

You should run a test review after the testing phase of your bugfix workflow has completed. It evaluates the fix and accompanying tests to recommend whether to return to fixing, add testing, or proceed with documentation.

Why does my bugfix pass tests but still not fix the original issue?

A bugfix might pass tests but not fix the original issue if the fix only addresses symptoms or drifts from the diagnosis. A thorough workflow critique verifies tests actually fail without the fix and align with the root cause.