| name | digest:digest |
| description | Summarize AI-generated branches, PRs, diffs, and design docs into structured digests with file breakdown, code walkthrough, and key concepts. Supports simple mode (-s) for plain language, report mode (-r) for full analysis with architecture impact, design decisions, risks, and recommendations, and export mode (--export) for markdown with Mermaid diagrams. Use when the user asks to explain, summarize, digest, or understand changes. |
Digest
Summarize AI-generated changes into structured digests that developers, reviewers, and stakeholders can quickly understand.
Usage
$digest # current branch vs main
$digest feat/new-auth # specific branch
$digest #42 # PR number
$digest docs/plans/auth.md # design doc
$digest --simple # plain-language output
$digest --report # full report (~5 min read)
$digest -r --export # export as markdown with Mermaid
Options
| Flag | Description |
|---|
-s, --simple | Plain, non-technical language |
-r, --report | Full report: architecture, design decisions, risks, recommendations |
--export | Export report as markdown with Mermaid diagrams (requires -r) |
Output modes: default (~1min) → -r (~5min)
Process
- Detect input type (PR, branch, design doc, or current branch)
- Dispatch the digest agent using the prompt template in
digest-agent.md (in this skill directory)
- Analyze changes and produce structured output based on mode
- Report the output back to the user (or write to file if
--export)
Agent Dispatch
Use the companion digest-agent.md in this directory as the agent prompt. Provide it with:
- Input type and target
- Simple mode flag
- Report mode flag
- Export mode flag
The agent uses $PROJECT_ROOT (set by the init hook) or falls back to git rev-parse --show-toplevel.
