butai

Author a self-contained, framework-free HTML document — a brief, report, or explainer — by reading the generated @butai/docs-kit catalog, composing its doc patterns (hero, section, callout, card grid, metric grid, table, comparison, decisions, timeline, code block, quote band, footer), and styling the whole page through the token contract with a chosen butai theme. Use when the user says '/create-doc', "make a page/doc/brief/report", "an explainer", "capture this as a browsable HTML artifact", "render this design / decision / comparison / plan as a page", or wants a themeable HTML document richer than markdown. One `.html` file, inline CSS, no external runtime deps — it opens and paints offline anywhere.

Author a new framework-free video scene into @butai/scene-kit — a standalone HTML document styled by the token contract, plus its frame.md design-spec and its meta.md catalog entry, then regenerate the catalog + registry. Use when the user says '/create-scene', "add a scene to the scene kit", "author a new HyperFrames scene", "create a title-card / callout / code / quote / outro scene", or wants a restyleable HTML scene that a theme can repaint. Scenes are raw HTML rendered to video by HyperFrames (consumed via `npx hyperframes`, never vendored). No React, no Remotion.

Compose a React/TSX slide deck from a talk outline — read the @butai/slide-kit catalog to pick real archetypes by intent, copy them into the project with `butai add`, wire them into the @butai/deck engine (SlideEngine / Slide), apply a butai theme, and write the deck to a generic, user-named target. Use when the user says '/create', "build the deck", "generate slides from this outline", "compose a presentation", or hands off a talk outline (typically from /outline) ready to become slides. Wires to the butai packages and a consumer-named slides directory — never a personal app path or barrel.

Author a new, complete butai theme as a standalone, contract-valid [data-theme] CSS file — read TOKEN_CONTRACT from @butai/patterns for the exact token names to fill, study the 13 @butai/themes as convention exemplars, fill EVERY required token plus a distinctive display font, then validate the block with validateThemeTokens so it has zero missing tokens. Use when the user says '/create-theme', "create a theme", "new theme", "make a <vibe> theme" (e.g. "a warm editorial theme", "a cyberpunk theme"), or wants to add a palette / color scheme for butai decks, scenes, and docs. Emits a standalone file — it never mutates the frozen @butai/themes package.

Plan and outline a talk or deck BEFORE any slides are built — run a short discovery (purpose, length, content-readiness, speaking-vs-reading density), draft a structured outline whose beats map to real @butai/slide-kit archetypes read from the generated catalog, verify it with the user, then write it to a generic, user-named location for /create to build. Use when the user says '/outline', "plan a talk", "help me shape this talk/deck", "outline my presentation", or has rough notes/screenshots to turn into a talk structure. This skill plans the outline only — it does not build slides or author themes.

Turn a STORYBOARD.md plus the butai scene kit into a video — parse the storyboard, preview the scenes as a themed contact sheet for free, then drive the real render through the user's own HyperFrames install via `npx hyperframes`. Use when the user says '/storyboard', "render this storyboard", "turn my STORYBOARD.md into a video", "preview my video scenes", or has a STORYBOARD.md and scenes ready. A real render costs credits and is a deliberate manual step; the default output here is the free contact-sheet preview. HyperFrames is an external tool, consumed via npx, never vendored.

Check every upstream in the repo-root sources.yml ledger for new releases/commits since it was last reviewed, summarize what changed, and propose what butai might adopt — then update each entry's last-checked date and reference and note that CREDITS.md should be regenerated. Data-driven: it reads the upstream names, urls, and repos from sources.yml at runtime and hardcodes none of them. Use when the user says '/sync-upstreams', "check my upstreams for updates", "sync the credits ledger", "what changed upstream", or "are any of our sources out of date". It proposes; a human always decides what to adopt.