CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

73

Quality

92%

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

90%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.

Excellent procedural content: concrete file paths, a complete code template, explicit build/verify commands, and zero educational padding. The two gaps keeping it from the top are the absence of a failure-recovery loop after the verification commands and the docs-update walkthrough being fully inlined rather than split into a reference file.

Suggestions

Add a short feedback loop after the step-7 checks, e.g., "If check-option-docs fails, fix the option definition (not the generated MDX) and re-run" — this would close the error-recovery gap in workflow clarity.

Consider moving the per-package docs-update walkthrough (CLI command pages, help metadata, API pages, config.mdx) into a references/docs-update.md file and linking to it from step 6 to slim the main body.

Clarify the ../studio-config-option-lifecycle/SKILL.md reference so its location relative to the skill bundle is unambiguous when the bundle is installed standalone.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no concepts are explained, every section delivers project-specific facts (file paths, type signatures, commands), and comments in the code template carry non-obvious information ("module-level default state", "defaults are resolved in getValue"). There is negligible padding, so it fits the 'lean and efficient; every token earns its place' anchor rather than anchor 4's 'minor instances of over-explanation'.

5 / 5

Actionability

Guidance is fully executable: a complete `satisfies AnyRemotionOption<boolean>` template with the real import path, exact file targets (`packages/renderer/src/options/<name>.tsx`, `parsed-cli.ts`, `print-help.ts`, `config/index.ts`), exact type signatures (`[myFlagOption.cliFlag]: TypeOfOption<typeof myFlagOption>`), and runnable build/verify commands (`bun run generate-option-docs`, `bun run check-option-docs`). Not below anchor 5 since the common boolean case is copy-paste ready and edge cases (negating flags, non-boolean types, SSR names) are addressed.

5 / 5

Workflow Clarity

The seven numbered steps are clearly sequenced with an explicit verification checkpoint ("Build and verify" with `check-option-docs` and verifying the generated `/docs/options/<id>` page), matching anchor 4. It is not anchor 5 because there is no error-recovery feedback loop — nothing tells Claude what to do when `check-option-docs` or the page verification fails; it is not anchor 3 because validation checkpoints are explicitly present, not merely implicit.

4 / 5

Progressive Disclosure

The single-file body is well organized: numbered sections, inline code kept to one template, a closing "Reference files" list of real codebase paths, and a clearly gated one-level-deep cross-reference ("If the option is consumed by Studio, read ../studio-config-option-lifecycle/SKILL.md completely before wiring it"). It sits between anchors 4 and 5 rather than clearly at 5: the body is ~130 lines (above the under-50-line simple-skill case) and the dense step-6 docs walkthrough across cli/lambda/cloudrun pages is content that could arguably live in a reference file; the sibling-skill path is also unverifiable within this bundle.

4 / 5

Total

18

/

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.

A strong description: it names the domain, enumerates the concrete actions of the workflow, and gives an explicit "Use when" trigger in third-person imperative voice. The only minor gap is that a few natural trigger synonyms ("flag", "CLI argument", "setting") are absent.

Suggestions

Consider adding one or two common synonyms such as "CLI flag" or "command-line argument" to the 'Use when' clause to broaden natural trigger coverage.

No other changes needed; keep the current structure of specific actions followed by the explicit trigger.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — "creating an AnyRemotionOption", "registering CLI parsing", "wiring config setters", "and updating documentation" — comprehensively covering the workflow. It matches the anchor for comprehensive concrete actions and is not below it since no part of the workflow is left to inference.

5 / 5

Completeness

It explicitly answers both parts: the what ("Add a new Remotion CLI or config option by creating an AnyRemotionOption, registering CLI parsing, wiring config setters, and updating documentation") and the when ("Use when adding or converting command-line flags or Remotion options"). This mirrors the anchor-5 example structure exactly, and anchor 4's looser 'when' does not fit better.

5 / 5

Trigger Term Quality

Natural phrases like "command-line flags", "Remotion options", "CLI", and "config option" cover what a contributor would say when needing this skill. It sits between anchors 4 and 5: good keyword coverage but a few natural synonyms (e.g., "CLI argument", "flag", "setting") are missing, so it is not the comprehensive anchor-5 fit.

4 / 5

Distinctiveness Conflict Risk

"Remotion CLI or config option" plus "AnyRemotionOption" carves out a clear niche with distinct triggers; virtually no other generic skill would fire on these phrases. Only the most minor overlap risk exists with the sibling studio-config-option-lifecycle skill, but the description's trigger (adding/converting flags) distinguishes it.

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

Path

.agents/skills/add-cli-option/SKILL.md

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.