菜单
Entry point for creating a new co-deck theme or style. PM dispatches the appropriate workflow (Style Workflow or T-Stage) based on user request. Responds to: "create a new theme", "add a new style", "make a dark theme", "create a dark style", "add zen theme".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Runs the full project sync pipeline — lifecycle update, audit, L0→L1 publish, commit, push, and PR creation.
Runs the full project sync pipeline — lifecycle update, audit, L0→L1 publish, commit, push, and PR creation.
Turn a topic or your own materials into a single self-contained, interactive HTML report — top tabs, clickable reference drawers, dense tables, comparison heatmaps, inline SVG, in-page search, a light/dark theme toggle, and multilingual support. Use when: user says "/explain-me", "/reportme", "make a report", "create report", "explain this topic". Inspired by beret21/reportme.
Document Production Workflow for co-deck — generates searchable, themed handbooks as static sites (GitHub Pages). Three modes: standalone handbook, lecture companion (reads co-deck slide_deck.md), full course site. Responds to "make handbook", "create handbook", "build course site", "companion handbook" (triggered by Korean phrases too). H-Stage pipeline (H-0 through H-7). Independent from the 11-Stage slide pipeline.
Turn a topic or your own materials into a single self-contained, interactive HTML report — top tabs, clickable reference drawers, dense tables, comparison heatmaps, inline SVG, in-page search, a light/dark theme toggle, and multilingual support. Use when: user says "/explain-me", "/reportme", "make a report", "create report", "explain this topic". Inspired by beret21/reportme.
Pre-edit fact-forcing quality gate. Ensures agents investigate a file's importers, schemas, and scope constraints before making changes. Part of the 3-layer enforcement model (Hook → Prompt → Skill).
| name | theme-authoring |
| scope | co-deck |
| version | 1.0.1 |
| description | Entry point for creating a new co-deck theme or style. PM dispatches the appropriate workflow (Style Workflow or T-Stage) based on user request. Responds to: "create a new theme", "add a new style", "make a dark theme", "create a dark style", "add zen theme". |
| status | active |
| owner | pm |
| last_reviewed | "2026-06-21T00:00:00.000Z" |
| prerequisites | pm |
co-deck uses a two-layer system: Theme (HTML structure + rendering paradigm) and Style (CSS variable set). Authoring either requires a dedicated pipeline separate from the 11-Stage lecture production pipeline.
docs/html-themes/themes/<name>/ → template.html + theme.json + pdf_layout_spec.jsondocs/html-themes/styles/<name>/ → style.css + pdf_color_spec.jsondocs/html-themes/THEMES.md — must be updated after every additiondocs/html-themes/preview/preview.html?theme=X&style=Y| User says | Route |
|---|---|
| "create a new style", "add dark style", "add style variant" | Style Workflow |
| "create a new theme", "add zen variant", "new theme" | T-Stage (Theme Workflow) |
Trigger: User requests a new visual style variant — changes color, font, or spacing only.
Ask the user:
dark-premium)Design agent authors two files in docs/html-themes/styles/<name>/:
style.css:
docs/html-themes/base/base.csspdf_color_spec.json:
THEMES.md schema)background, card_dark through card_dark4, text_primary through text_meta, accent, border, whitegen-slides-pdf.ts as Layer 2 in the 3-layer PDF mergedocs/html-themes/preview/preview.html?theme=pitch-enhanced&style=<name>pdf_color_spec.json path column)compatible_styles in each compatible theme's theme.jsondocs/lecture-profile.md style options commentTrigger: User requests a new HTML rendering paradigm — a new theme changes the DOM skeleton, navigation, and TOC structure.
Ask the user:
magazine, card-deck)html-build authors docs/html-themes/themes/<name>/template.html:
<!-- INJECT:CSS -->, <!-- INJECT:slideData -->, <!-- INJECT:slides --> placeholdersAlso authors docs/html-themes/themes/<name>/pdf_layout_spec.json:
page: dimensions (default 338.7×190.5mm 16:9; margin_mm: 0.0 for full-bleed themes)calibration.viewport_px: measure via Playwright (bun scripts/co-deck/measure-layout.ts) against template.html; set null if Playwright not available (px-based sizes will fall back to defaults)layout: all element position/size percentages derived from the HTML layoutfonts: title_pt, bullet_pt (mandatory); theme-specific sizes (e.g., punchline_pt for pitch-enhanced)slide_types: which slide types this theme uses (title, divider, punchline, standard)design authors docs/html-themes/themes/<name>/theme.json:
{
"name": "<name>",
"version": "1.0.0",
"description": "...",
"rendering": { "paradigm": "...", "navigation": "...", "progress_indicator": "..." },
"content_rules": {
"max_bullets_per_slide": N,
"max_title_chars": N,
"recommended_slide_count": "X-Y",
"slide_type_usage": {
"standard": "All content slides (mandatory)",
"punchline": "Last content slide only — single-statement message (≤1 line, no bullets)",
"divider": "Chapter/part boundaries only",
"profile": "Speaker intro only",
"title": "First slide (cover) only",
"contact": "Final slide only"
},
"notes": "..."
},
"compatible_styles": ["classic", "minimal"],
"incompatible_styles": [],
"toc_required": true|false,
"css_base": "docs/html-themes/styles/base.css"
}
storyline reviews and authors:
max_bullets, max_title_chars, and recommended_slide_count realistic for actual lecture production?recommended_structure field in theme.json:"recommended_structure": {
"pattern": "Cover → [Part Divider → 8-12 Content → Summary] × N → Contact",
"audience_fit": ["practitioner", "graduate"],
"notes": "..."
}
docs/html-themes/preview/preview.html?theme=<name>&style=classiccompatible_styles to each style's information in THEMES.mddocs/lecture-profile.md theme options commentagents/html-build.md → Available themes listRegistration Gate: After scaffolding, run
bun scripts/co-deck/verify-new-theme.ts <name>to validate the theme passes all 5 checks: (1) structural validation, (2) manifest freshness, (3) THEMES.md marker consistency, (4) fixture HTML build + extraction round-trip, (5) PDF generation. Use--fastto skip checks 4–5 during iterative development. Use--style <name>to test with a specific style (default:classic). Use--jsonfor machine-readable output. Registration is blocked until the gate exits 0.
docs/html-themes/styles/<name>/style.css (CSS variable overrides) + pdf_color_spec.json (12 role-based RGB keys)template.html (HTML skeleton + navigation JS) + pdf_layout_spec.json (geometry, layout percentages, slide_types)theme.json — content_rules + compatible_styles + slide_typesrecommended_structure field in theme.jsonStyle Workflow outputs:
docs/html-themes/styles/<name>/style.css — CSS variable override filedocs/html-themes/styles/<name>/pdf_color_spec.json — 12 role-based RGB color keysdocs/html-themes/THEMES.md — new row in Styles table + updated Compatibility MatrixTheme Workflow outputs:
docs/html-themes/themes/<name>/template.html — HTML skeletondocs/html-themes/themes/<name>/theme.json — metadata + content_rules + recommended_structure + slide_typesdocs/html-themes/themes/<name>/pdf_layout_spec.json — page geometry + layout percentages + font sizes + slide_typesdocs/html-themes/THEMES.md — new row in Themes table + updated Compatibility Matrixhtml-build — T-1 agent for template.html authoringdesign — T-2/S-2 agent for theme.json and style.css authoringstoryline — T-3 agent for content_rules validation and recommended_structuredocs/html-themes/THEMES.md — authoritative registrydocs/html-themes/preview/preview.html — preview tooldocs/html-themes/base/base.css — shared CSS variable foundationdocs/html-themes/themes/pitch-enhanced/ — reference theme (PPT-engine hybrid)docs/html-themes/themes/zen/ — reference theme (fullscreen stacked)