Docs / skills/showtime/references/index.md

Reference index

Read this when you need a reference SKILL.md does not point to directly, or you are not sure which file covers a question. Every file opens with its own "Read this when" line; read only what the current step needs.

Workflows (start here for a request)#

File	Read when the user wants
`references/workflows/launch-video.md`	a launch, promo or announcement video from a repo, app or URL
`references/workflows/explainer.md`	an idea, product or process explained (canvas film, voice-over, score)
`references/workflows/tutorial.md`	a tutorial, walkthrough or product demo (recorded app or drawn)
`references/workflows/social-short.md`	a reel, TikTok, Short, vertical cut-down or audiogram
`references/workflows/data-story.md`	numbers or charts animated into a story
`references/workflows/footage-edit.md`	recorded footage cut, captioned, reframed, cleaned or graded
`references/workflows/music-video.md`	picture cut or animated to a song
`references/workflows/changelog-video.md`	a pull request, release or changelog turned into a video
`references/workflows/trailer.md`	a teaser or trailer
`references/workflows/slideshow.md`	photos or screenshots set to music
`references/workflows/voiceover-only.md`	narration added to an existing video
`references/workflows/localize.md`	a video re-voiced or subtitled in another language

Working with the user#

File	Read when
`references/modes.md`	deciding how much to ask, switching quick/studio, writing the delivery card
`references/onboarding.md`	first run, setup missing, or the user asks what showtime needs
`references/studio.md`	the user wants options first, or accepted the studio offer
`references/boards.md`	writing or changing a studio board (`board.json`)
`references/review.md`	publish-bound work, a critique, or notes from the user or a critic
`references/diagnosing.md`	the user reports a problem ("it came out wrong", "setup failed")
`references/crew.md`	handing work to crew sub-agents; each role's brief is `references/crew/<role>.md`, shared rules in `references/crew/rules.md`
`references/harness-notes.md`	installing, or running showtime from another agent host, a script or CI
`references/mcp.md`	using showtime's MCP server from another client, the plugin settings, the progress monitor

Story and craft#

File	Read when
`references/story.md`	before writing any plan: angle, hook, structure, lines, honesty rules
`references/tones.md`	choosing a tone preset or translating the user's words into choices
`references/pacing.md`	setting holds, cut rhythm, beat sync, narration word budgets, durations
`references/motion-craft.md`	choosing easing, timing, stagger and camera moves
`references/typography.md`	picking fonts, sizes, spacing and safe areas for type
`references/color.md`	building a palette, checking contrast, grading footage
`references/platforms.md`	delivery specs, safe zones, posters and thumbnails, README loops (WebP/GIF), cut-downs and share copy per platform
`references/brand-kit.md`	the user mentions a brand, or gives a repo or site with a visual identity

Building HTML and canvas projects#

File	Read when
`references/render.md`	checking, snapping, previewing or rendering a project
`references/stage-api.md`	writing or debugging a page (`index.html` + `showtime.json`), the time contract
`references/components.md`	using DOM motion components (titles, captions, charts, frames, cursor, end card), or a stand-alone motion graphic (logo sting, lower third)
`references/transitions.md`	choosing scene handoffs (CSS and WebGL)
`references/film-api.md`	drawing a canvas film or tutorial with `Film`
`references/series.md`	a tutorial series: several episodes for one product sharing one kit (`showtime series`)
`references/html-export.md`	sharing a project as a single-file interactive HTML video (`showtime export html`)
`references/manim.md`	equations, proofs, graphs, grid transforms: math and diagram animation with Manim
`references/synth-score.md`	writing music or sound design in code with `Synth`
`references/debugging-renders.md`	a render fails, flickers, shows black or frozen frames, or differs from the preview

Sound and voice#

File	Read when
`references/audio.md`	composing, effects, the local library, beats, the mix spec, mastering
`references/music.md`	choosing or composing music and syncing it to picture
`references/sound-design.md`	placing effects, balancing voice against music, loudness targets
`references/voice.md`	narration: voices, scripts, word timings, pronunciation, alignment

Footage, capture and assets#

File	Read when
`references/editing.md`	editing real footage by transcript (the EDL and its rules)
`references/captions.md`	caption styles, grouping, sizes and safe zones for footage
`references/footage-tools.md`	one specific footage tool: probe, scenes, reframe, denoise, stabilize, grade, views
`references/capture.md`	material from a repo, a running app, a website or a PDF (`doc extract`); bot walls
`references/tutorial-recording.md`	scripting and recording an app demo, auto zoom
`references/assets.md`	fonts, icons, emoji, stock photos and video, cutouts, credits, a contact sheet of a folder of images

Verification#

File	Read when
`references/qa.md`	the checklists, the `showtime qa` rules and the `expect` block
`references/review.md`	building a review pack and running the critic pass
`references/debugging-renders.md`	a check or qa finding needs its cause found

View or edit this page on GitHub