CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

74

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

93%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an exemplary lean, executable procedure: exact paths, a complete code template, and an enforced docs step, with a terminal build/verify checkpoint. Its only gap is the absence of an explicit failure-recovery loop around the verify step, which keeps workflow clarity one notch below perfect.

DimensionReasoningScore

Conciseness

The body is lean and imperative — numbered steps, exact file paths, one complete code template, and no explanation of concepts Claude already knows (no preamble about what Remotion or CLI parsing is). Every token earns its place, matching anchor 5 rather than anchor 4, which would require some trimmable over-explanation.

5 / 5

Actionability

Guidance is fully executable: a copy-paste-ready `satisfies AnyRemotionOption<boolean>` template, exact file paths (`packages/cli/src/parsed-cli.ts`), precise type snippets (`[myFlagOption.cliFlag]: TypeOfOption<typeof myFlagOption>`), and concrete build commands (`bun run make`). It matches anchor 5; nothing is pseudocode or left abstract.

5 / 5

Workflow Clarity

Steps 1–7 are clearly sequenced, the docs step is flagged as mandatory ("IMPORTANT, do not skip this step"), and step 7 provides a build/verify checkpoint. It falls short of anchor 5 because there is no error-recovery feedback loop (e.g. what to do when `bun run make` fails or how to check the docs render), only a terminal verify step — anchor 4's 'most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

A single-file skill with no bundle directories (references/, scripts/, assets/ absent) and well-organized numbered sections; the one external pointer (`../studio-config-option-lifecycle/SKILL.md`) is clearly signaled, conditionally scoped ('If the option is consumed by Studio'), and one level deep, and the closing 'Reference files' list points directly at repo paths. It matches anchor 5's clear overview with well-signaled one-level-deep references; it is not anchor 4 because no content is misplaced or buried.

5 / 5

Total

19

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is excellent: it states concrete, comprehensive actions in third person and pairs them with an explicit, specific 'Use when' trigger clause. Its only minor weakness is that a few natural synonym phrasings (e.g. 'CLI argument') are absent, keeping trigger-term coverage just short of comprehensive.

DimensionReasoningScore

Specificity

The description enumerates concrete actions — "creating an AnyRemotionOption, registering CLI parsing, wiring config setters, and updating documentation" — giving comprehensive coverage of the workflow's phases, matching the top anchor's multiple specific concrete actions. It is not score 4 because the action list covers every major step of the task with no minor gaps, and not below because there is no vague or generic language.

5 / 5

Completeness

Explicitly answers both: what — the four concrete actions — and when — "Use when adding or converting command-line flags or Remotion options", with concrete trigger phrases. It clearly matches anchor 5 rather than anchor 4 because the 'when' clause is explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Strong natural terms users would say: "Remotion CLI", "config option", "command-line flags", "Remotion options", "adding or converting". It falls just short of anchor 5 because common synonyms like "CLI argument" or phrasings like "add a flag" variants are absent, matching anchor 4's 'good keyword coverage; a few natural terms missing' rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The Remotion-specific vocabulary ("Remotion CLI or config option", "AnyRemotionOption") carves out a clear niche with distinct triggers and minimal conflict risk with other skills. It matches anchor 5; it is not anchor 4 because the trigger terms are domain-unique rather than overlapping with closely related generic skills.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository
remotion-dev/remotion
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.