Agent skill · software engineering · remotion-dev
add-cli-option
Add a new Remotion CLI or config option by creating an AnyRemotionOption, registering CLI parsing, wiring config setters, and updating documentation. Use when adding or converting command-line flags or Remotion options.
Why this skill is useful
Adds specific implementation details for creating and registering new CLI options in Remotion, which the AI wouldn't reliably generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-08-06. 55,698 stars on the source repository.
What this skill does
Add a new CLI option How to convert a hardcoded CLI flag into a proper AnyRemotionOption, or add a brand new one. 1. Create the option definition Create packages/renderer/src/options/<name>.tsx: The type in AnyRemotionOption<T> and type: <default> as T determines the option's value type. Use boolean, string null, number null, etc. For negating flags (like --disable-ask-ai → askAIEnabled = false), handle the inversion in getValue. 2. Register in options index packages/renderer/src/options/index.tsx: Add the import (keep alphabetical within the import block) Add the option to the allOptions object This makes it available as BrowserSafeApis.options.myFlagOption throughout the codebase. 3. Update CLI parsed flags packages/cli/src/parsed-cli.ts: For boolean flags, add BrowserSafeApis.options.myFlagOption.cliFlag to the BooleanFlags array For non-boolean flags, no entry needed here (minimist handles them as strings/numbers automatically) packages/cli/src/parse-command-line.ts: Add to the destructured BrowserSafeApis.options In the CommandLineOptions type, add: [myFlagOption.cliFlag]: TypeOfOption<typeof myFlagOption>; 4. Use the option where needed Instead of reading parsedCli['my-flag'] directly, resolve via: For Studio options, this is typically in packages/cli/src/studio.ts. For render options, in the relevant render command file. If the option is consumed by Studio, read ../studio-config-option-lifecycle/SKILL.md completely before wiring it. Classify the option as startup-fixed or reloadable across all Studio consumers; mixed behavior is not allowed. If any consumer requires startup-fixed behavior, pass the startup snapshot to every consumer. Add lifecycle tests that prove the classification. 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills remotion-dev/add-cli-option