happier-review

Orchestrates evidence-backed code, plan, and release reviews with QA coverage ledgers and finding triage.

1.6k|141|Updated Dec 16, 2025
One-click install
npx skills add https://github.com/happier-dev/happier --skill happier-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: happier-review
Source: https://github.com/happier-dev/happier/tree/main/skills/happier-review
Command: npx skills add https://github.com/happier-dev/happier --skill happier-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Code reviews often stop at the diff, miss affected surrounding code, and produce vague or low-confidence findings. This Skill enforces a disciplined review process that maps the full affected corridor, builds a QA coverage ledger, triages findings by evidence and root cause, and issues clear advisory, boundary, or ship verdicts.

Core Features & Use Cases

  • Multi-target review orchestration: Review sessions, worktrees, commits, branches, PRs, features, plans, or release readiness with explicit change basis and affected-corridor analysis.
  • Structured QA coverage: Enumerate material behavior dimensions (success, failure, retry, persistence, compatibility, platform) and record PASS/FAIL/BLOCKED dispositions with evidence.
  • Finding triage and fix loops: Classify findings by claim, impact, response, and authority; optionally execute authorized root-cause fixes and re-review the changed corridor.
  • Use Case: Before merging a large feature branch, ask for a boundary review. The Skill inventories the change basis, delegates independent review lanes, runs QA scenarios, deduplicates findings by root cause, and produces a verdict with residual risks and exact next actions.

Quick Start

Use the happier-review skill to perform a boundary review of the current branch against its plan, including QA coverage and a merge-readiness verdict.

Frequently Asked Questions about happier-review

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

FAQPage Schema
How do I review a pull request with evidence-backed findings?

Request a PR review and the Skill resolves the actual PR base and head, maps the affected corridor beyond the diff, runs material QA scenarios, and reports only high-confidence actionable findings with severity, root cause, and validation requirements.

How do I verify a plan was fully implemented?

Ask for a plan-completeness review. The Skill decomposes the approved plan into material outcomes and invariants, then grades each as VERIFIED_COMPLETE, PARTIAL, MISSING, or CONTRADICTED based on wiring, tests, and runtime evidence rather than code presence alone.

What review output modes are supported?

Five modes exist: report (review only), comment (concise PR-style comments), qa (behavior validation without edits), staged (report then wait for approval before fixes), and fix (review, implement authorized root-cause fixes, validate, and re-review).

Can the review fix the issues it finds?

Only in fix mode or after approval in staged mode. Findings are clustered by root cause and canonical owner, executed through the implementation skill, then the changed corridor is re-reviewed for regressions and split-brains.

When should I not use this review orchestrator?

Do not use it for explicit release sign-off, which routes to the release-validation-review skill, or for runtime incident diagnosis, which belongs to the diagnose skill. It also avoids reviewing unrelated pre-existing code outside the affected corridor.