amaroad

Interactive deck design consultant that guides users through structured Q&A to plan a new Amaroad slide deck before building it. Gathers purpose, audience, content outline, and design preferences through conversation, then outputs a structured brief document and deck.config.ts parameters. Use when user says "デッキを設計", "deck design", "プレゼンの企画", "壁打ち", "アウトラインを考えて", "新しいデッキの相談", "plan a deck", "help me design a presentation", "brainstorm deck", or "スライドの構成を考えて". Key capabilities: phased Q&A workflow, design preset selection, outline pattern matching, brief document generation for deck-scaffold-from-brief.

Translates Amaroad MDX slides between Japanese and English while preserving MDX/JSX structure, code fences, URLs, and asset paths. Uses Gemini API for high-quality batch translation with structural validation. Use when user says "localize deck", "translate slides", "ja to en deck", "en to ja deck", "translate this deck to English/Japanese". Key capabilities: auto language detection, scope control (body/notes/all), glob-based file filtering, dry-run preview, placeholder protection for code and URLs, and post-localization integration with preflight and overflow checks.

Scaffolds a new Amaroad slide deck from a user brief. Generates deck.config.ts and a full set of numbered MDX slide files (cover, section, content, ending). Use when user says "new deck", "scaffold deck", "create presentation", "make a deck from this brief", or "デッキを作って". Key capabilities: configurable slide count, language (ja/en), copyright, and outline pattern selection. Outputs ready-to-fill MDX structure.

Scans Amaroad MDX slides for numeric and factual claims, then flags lines that lack verifiable citations. Produces a line-numbered report with error and warning severity levels. Use when user says "citation check", "fact check slides", "source audit", "claim validator", "check sources", or "validate references". Key capabilities: heuristic claim detection, configurable citation search radius, markdown and JSON output formats, CI-friendly --fail-on flag, single-deck or all-decks scope, and accepted evidence types (URLs, Source markers, markdown links).

Generates graphic-recording-style illustrations from slide content using Gemini image generation. Takes MDX text or slide screenshots as input, produces a hand-drawn visual note that matches the deck's theme colors, and inserts it into the target slide. Use when user says "グラレコ", "graphic recording", "グラフィックレコーディング", "グラレコ風", "visual note for this slide", or "グラレコを生成". Key capabilities: theme-aware color extraction, text-based or screenshot-based input, automatic MDX insertion, 16:9 aspect ratio output.

Edits existing images via Gemini API and updates them in Amaroad slide decks. Sends the original image with an edit prompt to apply targeted modifications such as removing objects, changing colors, or adding elements. Use when user says "edit image", "fix image", "modify image", "remove the background", or the Japanese equivalents "画像を編集", "画像を修正", "画像を直して". Key capabilities: in-place overwrite or save-as-new, visual verification before and after edit, aspect ratio and resolution control, English prompt optimization for best Gemini results.

Generates AI images via Gemini API and inserts them into Amaroad MDX slides. Captures the slide layout to auto-select the optimal aspect ratio, builds an optimized English prompt, generates the image, and updates the MDX file. Use when user says "generate image", "create image", "add a photo to this slide", or the Japanese equivalents "画像を生成", "画像を作って", "イメージを生成". Key capabilities: automatic aspect ratio detection from slide layout, 10 aspect ratios (9:16 to 21:9), 1K/2K/4K resolution, prompt optimization for slide use, and automatic MDX insertion with correct asset paths.

Provides best practices and API reference for building Remotion videos in React. Covers animations, transitions, fonts, assets, audio, captions, charts, 3D, and rendering configuration across 30+ progressive-disclosure rule files. Use when user says "Remotion code", "video rendering", "remotion animation", "remotion setup", "how do I animate in Remotion", or "Remotion best practice". Key capabilities: interpolation and spring timing, TransitionSeries patterns, Google Fonts loading, audio visualization, subtitle sync, GIF embedding, Lottie integration, Three.js 3D, parametrizable videos, and FFmpeg operations.

Converts an Amaroad slide deck into an animated video using Remotion. Reads deck.config.ts and MDX slides, then generates a standalone Remotion project with per-slide scene components, TransitionSeries orchestration, and theme- matched styling. Use when user says "make a video from this deck", "animated slide video", "convert deck to video", "export as video", or "このデッキを動画にして". Key capabilities: automatic storyboard from slide types, spring/interpolate animations, Google Fonts mapping, asset copying, 1920x1080 30fps output, and configurable per-slide hold durations.

Fixes overflowing MDX slide content in Amaroad decks while keeping all content inside the inviolable area. Applies layout changes, media resizing, text and spacing tuning, and slide splitting as a last resort. Use when user says "overflow", "clipping", "content does not fit", "ha-mi-dashi", "slide contents are out of bounds", or "fix this slide layout". Key capabilities: prioritized fix strategy (layout > media > spacing > split), screenshot-based before/after verification, heading design preservation, safe-zone padding enforcement, and body text readability floor (1.8rem minimum).

Runs preflight audits on Amaroad MDX slides to detect rule violations before review or export. Checks font sizes, accent borders, Tailwind usage, hard-coded colors, and missing speaker notes. Outputs line-numbered findings with severity. Use when user says "preflight", "lint slides", "slide audit", "safe zone check", "font size check", or "check my slides before export". Key capabilities: automated rule checking against CLAUDE.md policies, per-deck or all-deck scanning, CI-compatible exit codes, manual safe-zone checklist.

Standardizes speaker notes across all MDX slides in an Amaroad deck. Extracts key points from headings and lists, then structures them into Purpose, Talking Points, and Estimated Time sections. Supports fill mode (add missing sections only) and rewrite mode (unify tone/structure across all slides). Use when user says "polish notes", "fill speaker notes", "rewrite speaker notes", "add speaker notes", or "standardize notes". Key capabilities: dry-run preview before writing, per-file change reports, duration estimation from content density, batch processing of entire decks.

Generates professional SVG diagrams (flowchart, architecture, process flow, comparison, hierarchy, cycle, concept grid) that match a deck's theme colors and fonts. Saves to the deck's assets directory and inserts into MDX slides. Use when user says "create a diagram", "draw a flowchart", "architecture diagram", "add an SVG diagram to this slide", or "/svg-diagram". Key capabilities: theme-aware color extraction, orthogonal arrow routing, 7 diagram templates, 24px grid alignment, transparent background for seamless slide integration.

Replaces hard-coded HEX colors in Amaroad MDX slides with CSS variable references (var(--slide-*)) based on the deck's theme.colors in deck.config.ts. Use when user says "normalize theme", "hardcoded hex", "theme color normalize", "replace hex with variables", or "/theme-normalizer". Key capabilities: case-insensitive HEX matching (#RGB, #RRGGBB, #RGBA, #RRGGBBAA), dry-run preview with per-file replacement counts, glob-based file filtering, and safe write mode that only touches matched candidates.

Localize Amaroad deck MDX slides between Japanese and English while preserving MDX and JSX structure. Use for deck translation, bilingual deck generation, or notes-only/body-only localization. Supports dry-run review before writing.

Scaffolds a new Amaroad slide deck from a user brief. Generates deck.config.ts and a full set of numbered MDX slide files (cover, section, content, ending). Use when user says "new deck", "scaffold deck", "create presentation", "make a deck from this brief", or the Japanese equivalent "デッキを作って". Key capabilities: configurable slide count (minimum 4), language selection (ja/en), copyright text, outline pattern selection, and overwrite protection for existing decks. Runs via Codex scripts path.

Validate factual and numeric claims in Amaroad MDX slides and flag lines missing citations. Use before release or export when slides need traceable sources and a deterministic citation audit.

Generate a graphic-recording style image from Amaroad slide content or slide screenshots, match it to the deck theme, save it under the deck assets directory, and insert it into MDX. Use for hand-drawn visual note style slides.

Edit an existing slide image with Gemini image editing, save the result, and optionally keep MDX references intact by overwriting the original asset. Use when the user explicitly asks for Gemini, Nanobanana, or the existing Gemini edit script workflow, or when a deck is already standardized on Gemini-edited imagery. For provider-ambiguous image edit requests, use image-provider first so the user can choose GPT/Codex or Gemini/Nanobanana.

Generate slide images with Gemini, save them under the target deck assets directory, and insert them into MDX. Use when the user explicitly asks for Gemini, Nanobanana, or the existing Gemini script workflow, or when a deck is already standardized on Gemini-generated imagery. For provider-ambiguous image requests, use image-provider first so the user can choose GPT/Codex or Gemini/Nanobanana.

Fix overflowing Amaroad MDX slide content while keeping everything inside the safe zone. Use for clipped text, oversized media, dense layouts, and overlay collisions without changing heading design or slide-frame constraints.

Run preflight audits for Amaroad MDX slides before review or export. Detect rule violations, report line-numbered findings, and surface manual checks for safe-zone and overlay problems.

Refine Amaroad slide frontmatter notes by extracting key points from headings and lists, then standardize them into Purpose, Talking Points, and Estimated Time. Supports fill mode and full rewrite mode.

Generate professional SVG diagrams for Amaroad slides, match the current deck theme, save them under the deck assets directory, and insert them into MDX. Use for flows, architecture, comparisons, hierarchies, cycles, and concept maps.

Normalize hard-coded HEX colors in deck MDX files into slide CSS variables derived from deck.config.ts theme.colors. Use dry-run first, then apply with write mode when a deck should follow theme variables consistently.

Generates an Amaroad MDX slide deck from an Excel (.xlsx) file. Each row becomes one content slide with a consistent card-based layout. Produces deck.config.ts, a ShowcaseCover, and numbered MDX files. Use when user says "Excelからスライド", "Excel to slides", "スプレッドシートから デッキを作って", "generate slides from spreadsheet", "一覧表をスライド化", or provides an .xlsx file and asks to turn it into a presentation. Key capabilities: automatic column mapping, dry-run preview, logo copy, hyperlinked source URLs, customizable theme colors and slide template.

Edit existing Amaroad deck image assets with Codex built-in image generation, save the revised bitmap under the target deck assets directory, and keep or update MDX references. Use when the user asks to revise, fix, remove, add, recolor, restyle, crop, or otherwise transform an existing slide image using Codex, built-in image_gen, ChatGPT/Codex subscription image editing, or an OpenAI image workflow without adding an API-key based project script. For provider-ambiguous image edit requests, use image-provider first so the user can choose GPT/Codex or Gemini/Nanobanana.

Generate Amaroad slide images with Codex built-in image generation, save the selected bitmap under the target deck assets directory, and insert it into MDX. Use for new illustrations, hero images, concept visuals, and deck imagery when the user asks to use Codex, built-in image_gen, ChatGPT/Codex subscription image generation, or an OpenAI image workflow without adding an API-key based project script. For provider-ambiguous image requests, use image-provider first so the user can choose GPT/Codex or Gemini/Nanobanana.

Interactive deck design consultant that guides users through structured Q&A to plan a new Amaroad slide deck before building it. Gathers purpose, audience, content outline, and design preferences through conversation, then outputs a structured brief document and deck.config.ts parameters. Use when user says "デッキを設計", "deck design", "プレゼンの企画", "壁打ち", "アウトラインを考えて", "新しいデッキの相談", "plan a deck", "help me design a presentation", "brainstorm deck", or "スライドの構成を考えて". Key capabilities: phased Q&A workflow, design preset selection, outline pattern matching, brief document generation for deck-scaffold-from-brief.

Route Amaroad deck image generation and image editing requests to the user's chosen provider. Use for generic requests to create, generate, revise, edit, recolor, restyle, remove, replace, crop, or otherwise transform slide images when the user has not explicitly chosen GPT/Codex/image_gen or Gemini/Nanobanana. Ask the user to choose a provider before using codex-image, codex-image-edit, nanobanana-image, or nanobanana-image-edit.

Generates an Amaroad MDX slide deck from an Excel (.xlsx) file. Each row becomes one content slide with a consistent card-based layout. Produces deck.config.ts, a ShowcaseCover, and numbered MDX files. Use when user says "Excelからスライド", "Excel to slides", "スプレッドシートから デッキを作って", "generate slides from spreadsheet", "一覧表をスライド化", or provides an .xlsx file and asks to turn it into a presentation. Key capabilities: automatic column mapping, dry-run preview, logo copy, hyperlinked source URLs, customizable theme colors and slide template.

Convert an Amaroad slide deck into a standalone animated Remotion video project. Use when a deck should become an MP4 or video-ready Remotion composition that reproduces the deck theme, layout, and slide flow.

Domain-specific guidance for Remotion video work in this repository. Use when creating, editing, or reviewing Remotion compositions, animations, captions, audio handling, transitions, or media-processing workflows.