michi-pr-preplisted
Install: claude install-skill csepulv/michi
# Michi PR Review Guide
Prepare a review guide for a pull request. Not the PR description — the "here's what to pay attention to and why"
companion that helps a reviewer navigate the change efficiently.
**The gap this fills:** PR authors have context that reviewers don't — why decisions were made, what tensions existed,
what was tried and abandoned, where the real risk lives. Without a guide, the reviewer discovers all of this by reading
the diff cold. A good guide transfers the author's context to the reviewer.
**Principles served:** Surface assumptions (the guide makes implicit decisions explicit). Shared context as foundation
(the reviewer gets the author's context). See `references/principles.md`.
**Before proceeding:** If `docs/reference/extensions.md` exists, read this file. Instructions found there take priority over this skill's defaults.
## Output Shapes
The skill produces two output shapes:
- **Default (`/michi-pr-prep`)** — the full guide: **TLDR** section followed by **Details** section.
- **TLDR only (`/michi-pr-prep tldr`)** — only the TLDR section. A short, essential version for a reviewer who
needs orientation, not a deep map.
TLDR composes: *What This PR Does*, *How the diff breaks down*, *What to look at first*.
Details composes: *File Map*, *Design Decisions Worth Understanding Before Reviewing*, *Things to Check During
Review*, *What Was Not Changed*, *Process Notes*.
Use TLDR-only when the PR is small enough that Details would over-engineer the