review-compression

Shapes code changes and PR stacks into single-claim, locally reviewable diffs.

18|5|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/Neko-Catpital-Labs/Invoker --skill review-compression-neko-catpital-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-compression
Source: https://github.com/Neko-Catpital-Labs/Invoker/tree/main/skills/review-compression
Command: npx skills add https://github.com/Neko-Catpital-Labs/Invoker --skill review-compression-neko-catpital-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, mixed-purpose diffs are hard to review: reviewers cannot tell what changed, why the slice exists, or whether it is safe. This Skill structures implementation plans, Invoker YAML workflows, and PR stacks so every diff makes exactly one locally reviewable claim with an explicit safety invariant. ## Core Features & Use Cases - Required slice metadata: Every slice carries a Review claim, Review lane (behavior, refactor, proof, cleanup, policy, or docs), Safety invariant, Slice rationale, Architectural effect, Alternatives, and Non-goals. - Ordering and boundary rules: Enforces evidence-before-change, refactor-before-behavior, foundation-before-exposure sequencing, and splits work across architectural boundaries such as migration, write path, API, and UI. - Refactoring discipline: Distinguishes decomposition/extraction refactors (one top-level symbol per PR) from rehome/relocation refactors (git-mv-shaped slices with forwarding shims), and requires naming the Fowler technique in every refactor-lane PR. - Use Case: Before authoring a multi-PR stack that splits a large module, use this Skill to sequence one extraction per slice, confirm each safety invariant with the user, and write PR bodies that state the claim instead of summarizing files. ## Quick Start Use the review-compression skill to split my planned changes into a PR stack where each diff has one review claim and a confirmed safety invariant.

Frequently Asked Questions about review-compression

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

FAQPage Schema
How do I split a large PR into reviewable slices?

Split so each diff makes one locally reviewable claim with its own safety invariant. Separate behavior changes from refactors, split across architectural boundaries like migration, API, and UI, and keep optional cleanup in its own slice.

How should I structure a PR stack for extracting modules from a large file?

Move exactly one top-level symbol per PR: create the new module, move the symbol, and re-point references in the same diff so behavior is preserved. Sequence foundational units first, then delete dead original code in a separate slice once unused.

What is the difference between a rehome refactor and a decomposition refactor?

A rehome moves an already-cohesive file or package unchanged, producing a git-mv-shaped diff landed in one slice, optionally with a forwarding shim. Decomposition splits one file's symbols across multiple new modules, requiring one PR per extracted symbol.

When should a proof or regression test be its own PR?

A proof slice demonstrating a bug or benchmark lands before the fix it justifies, and its assertion must test the literal property named in the review claim, not a proxy signal. Bundling the proof harness with the fix mixes two claims.

Can I combine a rename with a bug fix in one commit?

No. Following Fowler's two-hats rule, structural and behavioral changes never share a diff. Land the rename first as a refactor-lane slice, then fix the bug as its own behavior-lane slice with its own review claim.