rai-quality-review

Audit changed story files for semantic bugs, type honesty, and test quality.

71|8|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/humansys/raise --skill rai-quality-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rai-quality-review
Source: https://github.com/humansys/raise/tree/main/packages/raise-cli/src/raise_cli/skills_base/rai-quality-review
Command: npx skills add https://github.com/humansys/raise --skill rai-quality-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify semantic bugs, type honesty failures, and low-value or fragile tests that automated gates and linters miss, preventing subtle regressions and maintenance debt before review.

Core Features & Use Cases

  • Systematically audit changed files for logic correctness, type honesty, error-handling issues, and language-specific idioms after implementation.
  • Evaluate test quality using mutation survival, refactor resilience, and behavior-specification heuristics to classify tests as Muda, Fragile, or Valuable.
  • Review API surface and basic security concerns, load project patterns and design context, and produce file:line findings with concrete fixes and a PASS / PASS WITH RECOMMENDATIONS / FAIL verdict.
  • Use Case: Run after story implementation and automated gates have passed to catch semantic issues and test weaknesses before the retrospective.

Quick Start

Run the rai-quality-review on a completed story that passed automated gates to generate inline file:line findings, remediation suggestions, and a final verdict.

Frequently Asked Questions about rai-quality-review

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

FAQPage Schema
How do I catch semantic bugs that automated linters miss?

To catch semantic bugs missed by automated linters, audit changed story files for logic correctness, type honesty failures, and language-specific idioms. This review evaluates diffs to produce file:line findings with concrete fixes, preventing subtle regressions before code review.

What is a fragile test and how do I identify low-quality tests?

Fragile tests break under harmless refactors. Identify low-quality tests by evaluating test behavior using mutation survival, refactor resilience, and behavior-specification heuristics, which classify tests as Muda, Fragile, or Valuable to isolate maintenance debt.

How do I audit code for type honesty failures after implementation?

Audit code for type honesty failures by reviewing changed file diffs after story implementation and automated gates pass. The review detects type honesty issues, evaluates the API surface, and generates a PASS, PASS WITH RECOMMENDATIONS, or FAIL verdict.

Does this code review approach work without automated gates passing first?

This code review approach requires automated gates to pass first. It runs on the set of changed files in a completed story after automated gates pass, requiring access to changed file diffs and project manifest or language detection to evaluate semantics.

What's the best way to review API surface and security concerns in changed files?

The best way to review API surface and security concerns in changed files is to load project patterns and design context alongside the file diffs. This evaluates language-specific semantics and security to produce file:line findings with explanations and a final verdict.