change-review

Runs multi-lens reviews over a release component's diff and records findings in the Marshall store.

Updated Jul 15, 2026
One-click install
npx skills add https://github.com/builtbyberry/marshall-claude-plugin --skill change-review-builtbyberry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: change-review
Source: https://github.com/builtbyberry/marshall-claude-plugin/tree/main/marshall/skills/change-review
Command: npx skills add https://github.com/builtbyberry/marshall-claude-plugin --skill change-review-builtbyberry

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reviewing a release component's diff across multiple expert lenses and tracking the resulting findings is hard to coordinate when review state lives in repo-local files that differ across machines, people, and agents. This Skill runs the configured change lenses against a component's diff and records findings durably in the shared Marshall store, so one person's review is visible to everyone working the release. ## Core Features & Use Cases - Multi-lens diff review: Loads the configured change lenses from the store, pre-filters them against the component's changed files with lenses_applicable, and fans out one subagent per applicable lens. - Store-backed findings: Reconciles fresh findings against existing kind: "change" findings and records the whole pass in one atomic record_findings call, with defer/accept/fix/re-open handled via resolve_finding. - Component scoping with fail-loud resolution: Resolves the component from an explicit ref, the active claim, or the branch name, and stops on any disagreement rather than mis-scoping findings. - Use Case: A developer finishes a backend component on a release branch and asks for a change review; the Skill fetches the diff against the default branch, runs only the lenses applicable to those files, and records findings visible to the whole release team. ## Quick Start Ask the assistant to run a change review on the current component of your Marshall-tracked release, for example by saying "review this component" or invoking /marshall:change-review with a component ref.

Frequently Asked Questions about change-review

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

FAQPage Schema
How do I run a change review on a release component?

Invoke /marshall:change-review with an optional component ref, or ask to review the current component. The Skill resolves the release and component, computes the diff against the default branch, runs the applicable lenses, and records findings in the Marshall store.

How are review findings stored and shared across a team?

Findings are recorded as durable rows of kind "change" in the hosted Marshall store via record_findings, not in a repo-local file. Because the store is shared, a review one person runs is visible to every machine, person, and agent working the release.

How does the skill decide which review lenses to run?

It reads the lens selection from project.reviews.change.lenses in the store, then pre-filters it with lenses_applicable against the component's changed files. Only applicable lenses are fanned out, and an empty selection stops the review.

What happens if the component cannot be resolved unambiguously?

The review stops and asks. The Skill resolves the component from an explicit ref, the active claim, or the branch name, and any disagreement between present signals is treated as ambiguity rather than letting one signal silently win.

Can I change which lenses are configured for a release?

Yes, use set_release_lenses with scope "change" before reviewing. The default target "project" writes a default shared by every release, while target "release" writes a per-release override that can later be cleared.

What is the difference between change review and release readiness?

Change review is component-scoped and approves or requires changes to one component, using verdicts like approve or changes-required. Release readiness is release-wide and decides whether to ship or hold the release.