القائمة
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)