bmad-checkpoint-preview

Guides human reviewers through code changes via structured walkthrough, risk, and testing steps.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-checkpoint-preview-unbakedcosmos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-checkpoint-preview
Source: https://github.com/unbakedcosmos/thumbnailer/tree/main/.claude/skills/bmad-checkpoint-preview
Command: npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-checkpoint-preview-unbakedcosmos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing a code change without context is slow and error-prone. This Skill turns a diff, commit, branch, or PR into a guided human-in-the-loop review: it reconstructs intent, organizes the change by design concern, surfaces high-risk spots, and suggests how to observe the behavior before you approve or reject. ## Core Features & Use Cases - Orientation & Intent Recovery: Identifies the change from conversation context, sprint status, or git state, then summarizes intent and surface-area stats (files, modules, boundary crossings, new public interfaces). - Concern-Based Walkthrough: Groups diff stops by design intent rather than by file, with clickable path:line references ordered for comprehension. - Risk & Testing Passes: Tags risk-sensitive spots (auth, schema, billing, security, config) ordered by blast radius, and suggests concrete manual observations of changed behavior. - Use Case: After finishing a feature branch, say "walk me through this change" — the Skill builds a review trail from the diff, walks you through each design concern, flags the riskiest lines, and ends with an approve/rework/discuss decision. ## Quick Start Ask the assistant to checkpoint-review the current branch or a specific commit, for example: "walk me through this change on my current branch."

Frequently Asked Questions about bmad-checkpoint-preview

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

FAQPage Schema
How do I review a code change with an AI assistant?▼

Trigger the checkpoint review by saying "checkpoint", "human review", or "walk me through this change". The Skill identifies the change from context, git state, or a PR reference, then guides you through orientation, walkthrough, risk, and testing steps.

How does the review walkthrough organize a large diff?▼

It groups changes by design concern rather than by file, selecting 2-5 cohesive intents with path:line stops ordered so each builds on the previous. Entry points and boundary crossings are presented first, peripherals like tests and config last.

Can it review a pull request from GitHub?▼

Yes. Pass a PR reference and it resolves it to a branch or commit via gh pr view. At wrap-up it can approve the PR with gh pr review --approve, but only after confirming with you since it is a visible shared action.

What happens if there is no spec or review trail for the change?▼

It falls back to generating a review trail from the diff itself, reading changed files in full and identifying 2-5 concerns with path:line stops. If git is unavailable and no diff can be retrieved, it continues with a non-trail review mode.

What kinds of risks does the detail pass detect?▼

It pattern-matches the diff against risk categories: auth, public API, schema, billing, infra, security, and config. Spots are ordered by blast radius, capped at five, and it explicitly reports when no high-risk spots exist rather than inventing findings.