Agent Skills

Overview

Amaroad ships with 18 specialized agent skills — in the .claude/skills/ directory for Claude Code and the .codex/skills/ directory for Codex. Each skill is triggered by natural language prompts and automates a specific workflow — from deck planning to video export. The three Codex image skills (image-provider, codex-image, codex-image-edit) are Codex-specific; the remaining 15 are shared across both agents.

Creation & Design

Deck Designer

Interactive Q&A consultant that guides you through planning a deck's structure, audience, and theme before building.

> design a deck
> help me plan a presentation

Outputs a structured brief to tasks/deck-brief-<name>.md that can be passed to the Deck Scaffold skill.

Deck Scaffold

Generates deck.config.ts and a full set of numbered MDX slide files from a brief or prompt.

> create a new deck
> scaffold deck from this brief

Excel to Slides

Generates an MDX slide deck from an Excel (.xlsx) file. Each row becomes one card-based content slide, alongside a generated deck.config.ts and cover.

> Excel to slides
> turn data/attack-catalog.xlsx into a deck

Supports automatic column mapping, dry-run preview, logo copy, and hyperlinked source URLs.

Image Provider

Routes generic image requests to your chosen engine. When you have not explicitly picked a provider, it asks you to choose Codex/GPT or Gemini/Nanobanana before generating or editing slide visuals.

> generate an image
> add a photo to this slide

Image Generation

Generates AI images via the Gemini (Nanobanana) API and inserts them into MDX slides. Automatically detects the optimal aspect ratio from 10 presets (9:16 to 21:9).

> generate an image with Nanobanana
> use Gemini to add a hero image

Image Editor

Edits existing images — remove objects, change colors, add elements — via the Gemini (Nanobanana) API and updates the MDX slide in place.

> edit this image with Gemini
> remove the background

Codex Image

Generates slide images with Codex/GPT built-in image generation, saves the bitmap under the deck's assets directory, and inserts it into MDX. Uses your Codex/ChatGPT subscription — no API-key script required.

> use Codex imagegen for this slide
> create a hero image with Codex

Codex Image Edit

Revises existing slide images with Codex/GPT built-in image generation — recolor, remove, add, crop, or restyle — and keeps MDX references in sync.

> edit this image with Codex
> recolor the background using Codex

SVG Diagram

Creates professional SVG diagrams (flowcharts, architecture maps, process flows, comparison, hierarchy, cycle, concept grids) that match your deck's theme colors.

> draw a flowchart
> create an architecture diagram

Supports 7 diagram templates with orthogonal arrow routing and 24px grid alignment.

Graphic Recording

Generates graphic-recording-style illustrations from slide content using Gemini image generation.

> graphic recording
> グラレコ
> visual note for this slide

Video & Localization

Remotion Video

Converts a Amaroad slide deck into an animated video using Remotion with spring animations, Google Fonts mapping, and asset copying.

> make a video from this deck
> export as video

Outputs a standalone Remotion project at 1920x1080 30fps with configurable per-slide hold durations.

Deck Localizer

Translates slides between Japanese and English while preserving MDX/JSX structure, code fences, URLs, and asset paths. Uses Gemini API for batch translation.

> translate to English
> localize this deck to Japanese

Supports dry-run preview and glob-based file filtering.

Quality Assurance

Overflow Fixer

Auto-fixes overflowing slide content using a prioritized strategy: layout changes → media resizing → spacing tuning → slide splitting.

> fix overflow
> content does not fit

Uses screenshot-based before/after verification to confirm fixes.

Preflight Auditor

Runs automated audits on MDX slides to detect rule violations before review or export.

> preflight check
> lint my slides

Checks for: minimum font sizes, accent border rules, Tailwind usage in slides, hard-coded colors, and missing speaker notes. CI-compatible exit codes.

Speaker Notes

Standardizes speaker notes across all slides with Purpose, Talking Points, and Estimated Time sections.

> polish notes
> add speaker notes to all slides

Supports fill mode (add missing sections) and rewrite mode (unify tone/structure).

Fact Checker

Scans slides for numeric and factual claims, then flags lines that lack verifiable citations.

> citation check
> validate references

Supports Markdown and JSON output formats with CI-friendly --fail-on flag.

Theme Normalizer

Replaces hard-coded HEX colors in MDX slides with CSS variable references (var(--slide-*)) based on your deck's theme.colors.

> normalize theme
> replace hex with variables

Supports dry-run preview with per-file replacement counts.

Reference

Remotion Best Practices

Provides best practices and API reference for building Remotion videos — animations, transitions, fonts, assets, audio, captions, charts, 3D, and rendering configuration.

> Remotion best practice
> how do I animate in Remotion

Includes 30+ progressive-disclosure rule files covering interpolation, spring timing, TransitionSeries, Google Fonts, audio visualization, and subtitle synchronization.

Summary