add-cli-option

Registers new Remotion CLI flags as typed options with config setters and documentation.

Updated May 15, 2026
One-click install
npx skills add https://github.com/danielbere1973/promoar --skill add-cli-option-danielbere1973
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-cli-option
Source: https://github.com/danielbere1973/promoar/tree/main/.agents/skills/add-cli-option
Command: npx skills add https://github.com/danielbere1973/promoar --skill add-cli-option-danielbere1973

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding a new command-line flag to the Remotion codebase requires touching many files: the option definition, the options index, CLI parsing, type declarations, config setters, and documentation. This Skill provides the exact step-by-step procedure so nothing is missed and the option follows the established AnyRemotionOption pattern. ## Core Features & Use Cases - Option Definition: Creates a typed AnyRemotionOption in packages/renderer/src/options with getValue/setConfig logic and CLI flag resolution. - CLI & Config Wiring: Registers the flag in parsed-cli.ts, parse-command-line.ts, and the Config object so it works across CLI, Studio, and render commands. - Mandatory Docs Updates: Ensures every new option uses the <Options id="..." /> component in CLI command pages and config.mdx for a single source of truth. - Use Case: When converting a hardcoded flag like --disable-ask-ai into a proper option, follow the guide to create the option file, register it, add the setAskAIEnabled config setter, and update the docs. ## Quick Start Add a new boolean CLI flag called --my-flag to Remotion with a config setter and updated documentation.

Frequently Asked Questions about add-cli-option

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new CLI flag to Remotion?▼

Create an AnyRemotionOption file in packages/renderer/src/options, register it in the options index, add the flag to parsed-cli.ts and parse-command-line.ts, wire a config setter in packages/cli/src/config/index.ts, and update the docs with the Options component.

How do I convert a hardcoded CLI flag into a Remotion option?▼

Replace direct reads of parsedCli with an AnyRemotionOption whose getValue resolves the CLI flag first and falls back to config state. Then replace any hand-written docs description with the <Options id="..." /> component.

Where are Remotion CLI boolean flags registered?▼

Boolean flags are added to the BooleanFlags array in packages/cli/src/parsed-cli.ts. Non-boolean flags need no entry there because minimist parses them as strings or numbers automatically.

How do negating flags like --disable-ask-ai work in Remotion?▼

Negating flags handle the inversion inside the option's getValue function, so a flag like --disable-ask-ai sets askAIEnabled to false. The option definition keeps the logic in one place.

Why must Remotion option docs use the Options component?▼

The <Options id="..." /> component pulls the description directly from the option definition, keeping documentation as a single source of truth. Hand-written descriptions risk drifting out of sync with the implementation.