html-ppt-knowledge-arch-blueprint — Claude Code skill
html-ppt-knowledge-arch-blueprint — a skill that produces management-grade HTML presentation decks using the knowledge-arch-blueprint template's layout and visual system. Built for incident retros, roadmaps and architecture decisions.
Apache-2.0 184 installs ★ 108,855 updated 2026-10-25
npx skills add nexu-io/open-design --skill html-ppt-knowledge-arch-blueprint -a claude-codeWhat html-ppt-knowledge-arch-blueprint does
This is an entry point into the master html-ppt skill that activates the full-featured knowledge-arch-blueprint template — a visual system for platform VP or product manager–level decks. The template ships with slide layouts, styling tokens, keyboard navigation, animations and speaker notes. The skill copies index.html and style.css from the template folder, wires the shared runtime (base.css, animations.css, runtime.js) and ensures relative asset paths resolve in the project.
The deck builds as a single HTML file or a folder of linked files. Authoring rules, structural classes and notes handling live in the master skill at design-templates/html-ppt/SKILL.md. The template recognises only the classes that shipped with it — new ones need manual CSS. To change the color scheme, the skill can load any of the 36 themes from assets/themes/*.css.
The visual system, layouts and keyboard model come from the MIT-licensed lewislulu/html-ppt-skill repository. The LICENSE file sits at design-templates/html-ppt/LICENSE — keep it when redistributing.
What it helps with
- build an HTML presentation deck for an incident retro or architecture review
- produce management-grade slides with speaker notes
- use a complete visual system without a framework
- switch presentation themes live with the
Tkey during playback
Example prompts for the agent
- Build a
knowledge-arch-blueprintdeck for the daemon-restart incident retro - Create architecture roadmap slides in the
knowledge-arch-blueprintvisual system - Copy the
knowledge-arch-blueprinttemplate into the project and fixruntime.jspaths
How to install html-ppt-knowledge-arch-blueprint
1Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill html-ppt-knowledge-arch-blueprint -a claude-code2Manually: put the files in place
~/.claude/skills/html-ppt-knowledge-arch-blueprint/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/html-ppt-knowledge-arch-blueprint/
1Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill html-ppt-knowledge-arch-blueprint -a codex2Manually: put the files in place
.agents/skills/html-ppt-knowledge-arch-blueprint/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill html-ppt-knowledge-arch-blueprint -a cursor2Manually: put the files in place
.cursor/skills/html-ppt-knowledge-arch-blueprint/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install nexu-io/open-design design-templates/html-ppt-knowledge-arch-blueprint/SKILL.md2Manually: put the files in place
.github/skills/html-ppt-knowledge-arch-blueprint/SKILL.md1Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill html-ppt-knowledge-arch-blueprint -a gemini-cli2Platform CLI
gemini skills install https://github.com/nexu-io/open-design --path design-templates/html-ppt-knowledge-arch-blueprintManually: put the files in place
.devin/skills/html-ppt-knowledge-arch-blueprint/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill html-ppt-knowledge-arch-blueprint -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about html-ppt-knowledge-arch-blueprint
How to install html-ppt-knowledge-arch-blueprint in Claude Code?
Run npx skills add nexu-io/open-design --skill html-ppt-knowledge-arch-blueprint -a claude-code, then open ~/.claude/skills/html-ppt-knowledge-arch-blueprint/SKILL.md.
What does html-ppt-knowledge-arch-blueprint do?
It creates management-grade HTML presentation decks in the knowledge-arch-blueprint template's visual system — with layouts, themes, animations and speaker mode.
Why does navigation break in the copied deck?
The template references ../../../assets/..., which only works in the original repository tree. Copy fonts.css, base.css, animations.css and runtime.js into a project-local assets/ folder and rewrite the paths in index.html, or inline their contents directly into the HTML with <style> and <script> tags.
Source text
SKILL.md · Apache-2.0
---
name: html-ppt-knowledge-arch-blueprint
en_name: "Turn an Incident Retro into a Learning Deck like a Platform VP"
zh_name: "像平台 VP 一样把事故复盘写成学习稿"
description: |
OpenDesign's incident retro: the daemon-restart data bug, the root cause, the fix, and the systemic follow-ups. Built as a decision-grade product management deck for engineering, SRE, leadership.
en_description: |
OpenDesign's incident retro: the daemon-restart data bug, the root cause, the fix, and the systemic follow-ups. Built as a decision-grade product management deck for engineering, SRE, leadership.
zh_description: |
像平台 VP 一样把事故复盘写成学习稿——一份可商业交付的产品管理 Deck,围绕真实主题、证据链与决策目标组织。
tags:
- "product-management"
- "pm-feature-business-case-deck"
- "product"
- "roadmap"
- "architecture"
- "decision-deck"
- "commercial-slide-agent"
- "html-ppt-knowledge-arch-blueprint"
triggers:
- "pm-feature-business-case-deck"
- "product-management"
- "Turn an Incident Retro into a Learning Deck like a Platform VP"
- "像平台 VP 一样把事故复盘写成学习稿"
- "product"
- "roadmap"
- "architecture"
- "html deck"
- "html slides"
od:
mode: deck
upstream: "https://github.com/lewislulu/html-ppt-skill"
preview:
type: html
entry: index.html
design_system:
requires: false
speaker_notes: true
animations: true
category: "product-management"
scenario: "product"
example_prompt: "Create \"Turn an Incident Retro into a Learning Deck like a Platform VP\" as a decision-grade Product management deck in this template's own visual system. Subject: OpenDesign's incident retro: the daemon-restart data bug, the root cause, the fix, and the systemic follow-ups. Audience: engineering, SRE, leadership. First ask only for missing essentials: audience, decision target, source-of-truth materials, deadline, and must-keep numbers. Then produce the slide plan, written slides, visual direction, speaker-ready structure, and a critic pass against this rubric: can cross-functional reviewers agree on the next irreversible step."
---
# HTML PPT · 奶油蓝图架构
A focused entry point into the [`html-ppt`](../html-ppt/SKILL.md) master skill that lands the user directly on the **`knowledge-arch-blueprint`** full-deck template.
## When this card is picked
The Examples gallery wires "Use this prompt" to the example_prompt above. When you accept that prompt, this card is the right pick if the user wants exactly the visual identity of `knowledge-arch-blueprint` (see the upstream [full-decks catalog](../html-ppt/references/full-decks.md) for screenshots and rationale).
## How to author the deck
1. **Read the master skill first.** All authoring rules live in
[`design-templates/html-ppt/SKILL.md`](../html-ppt/SKILL.md) — content/audience checklist,
token rules, layout reuse, presenter mode, the keyboard runtime, and the
"never put presenter-only text on the slide" rule.
2. **Start from the matching template folder:**
`design-templates/html-ppt/templates/full-decks/knowledge-arch-blueprint/` — copy `index.html` and
`style.css` into the project, keep the `.tpl-knowledge-arch-blueprint` body class.
3. **Bring the shared runtime with the template.** The upstream
`index.html` links the shared CSS/JS via `../../../assets/...` because it
sits three folders deep inside `design-templates/html-ppt/templates/full-decks/`.
Once you copy `index.html` into the project, those parent-relative URLs
no longer resolve and `base.css`, `animations.css`, and `runtime.js`
will 404 — meaning the deck never activates and slide navigation is
dead. Pick one of these two recipes per project:
- **Recipe A — copy + rewrite (preferred):** copy
`design-templates/html-ppt/assets/fonts.css`, `design-templates/html-ppt/assets/base.css`,
`design-templates/html-ppt/assets/animations/animations.css`, and
`design-templates/html-ppt/assets/runtime.js` into a project-local
`assets/` (with `assets/animations/animations.css`), then rewrite the
four `<link>`/`<script>` tags in `index.html` from
`../../../assets/...` to the matching project-local paths
(`assets/fonts.css`, `assets/base.css`,
`assets/animations/animations.css`, `assets/runtime.js`).
- **Recipe B — inline:** read the same four files and replace each
`<link rel="stylesheet" href="../../../assets/...">` with a
`<style>...</style>` containing the file's contents, and the
`<script src="../../../assets/runtime.js">` with a
`<script>...</script>` containing `runtime.js`. Yields a single
self-contained `index.html`.
Either way, do not ship the upstream `../../../assets/...` URLs
verbatim into a project artifact — they only work in-tree.
4. **Pick a theme.** Default tokens look fine; if the user wants a different
feel, swap in any of the 36 themes from `design-templates/html-ppt/assets/themes/*.css`
via `<link id="theme-link">` and let `T` cycle.
5. **Replace demo content, not classes.** The `.tpl-knowledge-arch-blueprint` scoped CSS only
recognises the structural classes shipped in the template — keep them.
6. **Speaker notes go inside `<aside class="notes">` or `<div class="notes">`** — never as visible text on the slide.
## Attribution
Visual system, layouts, themes and the runtime keyboard model come from
the upstream MIT-licensed [`lewislulu/html-ppt-skill`](https://github.com/lewislulu/html-ppt-skill). The
LICENSE file ships at `design-templates/html-ppt/LICENSE`; please keep it in place when
redistributing.
© nexu-io · Apache-2.0 · nexu-io/open-design