code-review

Reviews code diffs with parallel adversarial review layers and structured triage.

Updated Sep 6, 2026
One-click install
npx skills add https://github.com/JHAMILCALI/Stellar-Build --skill code-review-jhamilcali
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: code-review
Source: https://github.com/JHAMILCALI/Stellar-Build/tree/main/.claude/skills/code-review
Command: npx skills add https://github.com/JHAMILCALI/Stellar-Build --skill code-review-jhamilcali

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manual code reviews often miss edge cases, acceptance criteria violations, and subtle bugs because a single reviewer has limited perspective. This Skill runs multiple adversarial review layers in parallel and triages findings into actionable categories, so nothing slips through and every issue gets a clear resolution path. ## Core Features & Use Cases - Parallel Adversarial Review: Launches three independent review layers — Blind Hunter (diff-only), Edge Case Hunter (diff plus project access), and Acceptance Auditor (diff plus spec) — to catch issues from different angles. - Structured Triage: Normalizes, deduplicates, and classifies findings into decision-needed, patch, defer, or dismiss buckets, then writes them to the story file and deferred-work log. - Sprint Integration: Detects stories in review status from sprint-status.yaml, updates story status after review, and syncs sprint tracking automatically. - Use Case: After finishing a story implementation, run the review against your branch diff and spec file; the Skill identifies acceptance criteria violations, applies approved patches, and marks the story done in sprint tracking. ## Quick Start Ask the AI to run code review on your current branch changes against the story spec file.

Frequently Asked Questions about code-review

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

FAQPage Schema
How do I run an adversarial code review on a git diff?▼

Provide a diff source such as a branch, commit range, staged changes, or pasted diff, and the workflow launches parallel review layers. Each layer examines the diff independently, then findings are triaged into patch, defer, decision-needed, or dismiss categories.

What diff sources can I review with this workflow?▼

You can review uncommitted changes, staged changes only, a branch diff against a base branch, a specific commit range, a user-provided diff, or a list of files. The workflow validates each source and halts if the diff is empty or unparseable.

Does the code review work without a spec file?▼

Yes, it runs in no-spec mode where the Acceptance Auditor layer is skipped. Findings that would require human decisions are reclassified as patch or defer since there is no spec to resolve ambiguity against.

What happens if a review subagent fails or times out?▼

The failed layer name is recorded and the review proceeds with findings from the remaining layers. If zero findings remain and any layer failed, the workflow warns that the review may be incomplete instead of declaring a clean review.

Can the review update sprint status automatically?▼

Yes, when a story key is known, the workflow updates the story file status to done or in-progress based on review outcome and syncs the matching entry in sprint-status.yaml while preserving file structure and comments.

What are the limitations of automated adversarial code review?▼

Very large diffs over roughly 3000 lines should be chunked by file group to stay effective. Also, decision-needed findings require a spec file, and without subagent support you must run each reviewer prompt in separate sessions manually.