skill-staged-review

Enforce two-stage review for spec compliance and code quality before merge.

4.0k|369|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/nyldn/claude-octopus --skill skill-staged-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-staged-review
Source: https://github.com/nyldn/claude-octopus/tree/main/skills/skill-staged-review
Command: npx skills add https://github.com/nyldn/claude-octopus --skill skill-staged-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Separates spec compliance from code quality to ensure features meet intended goals and pass rigorous quality gates before merge.

Core Features & Use Cases

  • Stage 1: Spec Compliance validates implementation against the loaded intent contract, including success criteria and boundary checks.
  • Stage 2: Code Quality performs stub detection and a full quality review addressing architecture, error handling, security, performance, readability, and test coverage.
  • Gate-based decisioning ensures both stages pass before progression, surfacing actionable fixes when anything fails.
  • Error handling and fallback: if no intent contract exists, the process warns and proceeds to Stage 2; if no changes are detected, the review reports nothing to review.

Quick Start

Run the staged-review process on your feature branch to validate spec compliance and code quality before merging.

Frequently Asked Questions about skill-staged-review

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

FAQPage Schema
How do I enforce spec compliance before a pull request code review?

Spec compliance is enforced by loading an intent contract to validate success criteria and boundary checks before progressing to a full code quality review. This two-stage process ensures features meet intended goals before merging.

What is a two-stage review process for pull requests?

A two-stage review process separates spec compliance validation from code quality checks to ensure features meet goals and pass rigorous gates. Stage 1 validates intent contracts, while Stage 2 performs full quality and stub detection.

How do I check code quality and detect stubs before merging a feature branch?

Code quality and stub detection are checked during the second stage of a staged review, which validates architecture, error handling, security, performance, readability, and test coverage before merge readiness is determined.

What happens during code review if no intent contract exists for my feature?

If no intent contract exists, the staged review process warns the user and proceeds directly to Stage 2 code quality checks. This fallback ensures code quality validation still occurs even without explicit spec compliance criteria.

Can I use staged review for major feature validation or only minor pull requests?

Staged review is applicable to major feature work, pull request preparation, or any scenario requiring staged validation. Gate-based decisioning ensures both spec compliance and quality stages pass before progression.

Why does a staged review report nothing to review on my feature branch?

A staged review reports nothing to review when no changes are detected on the feature branch. This ensures the validation process only triggers gate-based decisioning when actual code modifications exist to assess.