From lumen
Generate single-file HTML project recap that rebuilds mental model of project's current state, recent decisions, and cognitive debt hotspots. Invoke when user asks to recap, summarize the project, show me where we are, or returns to project after break.
How this skill is triggered — by the user, by Claude, or both
Slash command
/lumen:lumen-recapThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Single-file HTML recap. Hero image (optional) + architecture diagram + activity narrative + decision log + state KPIs + mental model + debt hotspots + next steps.
Single-file HTML recap. Hero image (optional) + architecture diagram + activity narrative + decision log + state KPIs + mental model + debt hotspots + next steps.
📄 Rendered example: docs/examples/recap.html (a real recap of this repo)
Tier: capability (atomic) — does not invoke other lumen skills. Composites and playbooks may invoke it.
Triggers: recap, summarize the project, where are we, rebuild mental model, project state, coming back to this project, what changed since last week.
Follow the full recipe in references/recap-recipe.md (lifted from visual-explainer). Summary:
$1 shorthand (2w, 30d, 3m) → git --since format. Default 2w.README.md, CHANGELOG.md, package.json, dep manifests, top-level structure.git log --oneline --since=…, git log --stat, git shortlog -sn.git status, git branch --no-merged, TODO/FIXME in recently changed files, progress docs.lumen-mermaid for the shell)In addition to the 8-section project recap above, lumen-recap supports a 6-section research template for summarizing investigations, competitive analysis, or decision-support material:
file:line). Minimum 3 distinct sources per major claim.When triggered for research-oriented prompts (research this, compare options, should we use X), default to the 6-section template. When triggered for project-state prompts (recap, where are we), default to the 8-section project recap.
Single HTML written to ~/.agent/lumen/. Open in browser.
file:line.min-width: 0 on grid/flex children; overflow-wrap: break-word.display: flex on <li> for marker characters — use absolute positioning.file:line source (per shared validation-first convention).skills/_shared/instructions.md for aesthetics, file-handling, browser-launch, and citation conventions.Permanently skill-path only by design. lumen-recap is a multi-step CC skill that needs Read / Grep / Bash (git log) tool access to introspect project state. A deterministic PI tool cannot gather this data without the caller serializing the entire project into content, which defeats the skill's purpose.
nicobailon/visual-explainer commands/project-recap.md (MIT) — full recipe lifted to references/recap-recipe.mdlumen-mermaid (this package) — for the architecture-snapshot Mermaid shell with zoom/panlumen-diagram (this package) — fgraph alternative when Mermaid would be too dense (>15 components)npx claudepluginhub monsieurbarti/lumen --plugin lumenCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.