CtrlK
BlogDocsLog inGet started
Tessl Logo

remotion-markup

Best practices for writing Remotion React Markup

60

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./packages/skills/skills/remotion-markup/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

92%

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 exceptionally lean, highly actionable Remotion reference with executable code, exact commands, and clear conditional guidance. Its one real defect is that the progressive-disclosure references point to bundle files that are not present, undermining the otherwise excellent file-split navigation.

Suggestions

Ship the referenced bundle files (text-highlights.md, voiceover.md, effects.md, transitions.md, etc.) in references/ so the one-level-deep navigation actually resolves.

Consider moving the long effects-name catalog (line 173) into effects.md and linking to it, keeping SKILL.md as a tighter overview.

Add a short orienting line near the top summarizing what the reader will find in the inline rules versus the linked sub-files to aid navigation.

DimensionReasoningScore

Conciseness

The body is a lean, rule-dense reference with terse directives like 'Animate properties using `useCurrentFrame()` and `interpolate()`' and 'CSS transitions or animations are FORBIDDEN', assuming Claude's competence and never explaining what Remotion or React is; every line earns its place, fitting 'lean and efficient; assumes Claude's competence'. The only large block is the effects-name catalog, which is actionable reference material rather than padding, so it stays at score 3 rather than 2.

3 / 3

Actionability

It provides fully executable tsx components (e.g., `FadeIn`, `MyComposition`), exact CLI commands (`npx remotion still [composition-id] --scale=0.25 --frame=30`, `npx remotion add @remotion/media`), specific named APIs (`Interactive.Div`, `Easing.bezier(0.16, 1, 0.3, 1)`), and good/bad (👍/👎) contrast examples, matching 'fully executable code/commands; copy-paste ready'.

3 / 3

Workflow Clarity

Though primarily a rule reference, the guidance that does involve sequencing is unambiguous: the visual-effects section gives an explicit ordered priority (1→2→3→4) and the preview/render-check sections state clear conditions ('Skip it for trivial edits', 'Only do this if you think the user wants to see the preview'). As a non-destructive reference skill it does not require validation feedback loops, so clear conditional ordering here warrants score 3 rather than 2.

3 / 3

Progressive Disclosure

On paper the body is an overview pointing to ~30 separate one-level-deep files, each clearly signaled with 'See [file.md]' plus a one-line topic description, but the referenced bundle files (text-highlights.md, voiceover.md, effects.md, etc.) do not exist on disk — there is no references/, scripts/, or assets/ directory and no sibling .md files. Well-signaled but broken references cannot reach score 3, and it sits above score 1 because the intended structure and navigation are clear and shallow.

2 / 3

Total

11

/

12

Passed

Description

50%

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 concise and identifies a clear niche, but it is generic in its action language and entirely lacks an explicit 'when to use it' trigger clause. It reads as a topic label more than a trigger-rich capability statement.

Suggestions

Add an explicit 'Use when...' trigger clause naming natural terms users would say (e.g., 'Use when animating, sequencing, or rendering video with Remotion, or when writing Remotion components/compositions').

Replace the abstract 'writing ... markup' with concrete capabilities (e.g., 'Animate React components, sequence scenes, embed audio/video, and apply visual effects in Remotion').

Include common keyword variations (Remotion compositions, React video, timeline animations, Studio-editable components) to improve trigger coverage.

DimensionReasoningScore

Specificity

The phrase 'Best practices for writing Remotion React Markup' names the domain but only implies a single abstract action ('writing... markup') rather than listing concrete capabilities, matching the 'names domain and some actions, but not comprehensive' anchor; it is not score 1 because it does specify a clear domain, and not score 3 because no multiple specific actions are enumerated.

2 / 3

Completeness

It gives a weak 'what' (best practices for writing markup) but no explicit 'when to use it' trigger clause, and the rubric caps completeness at 2 when a 'Use when...' clause is missing; it is not score 1 because some 'what' is present, and not score 3 because there is no explicit when.

2 / 3

Trigger Term Quality

'Remotion React Markup' provides a relevant named keyword but is phrased as a topic rather than how users naturally phrase a need, and it omits common variations, fitting 'some relevant keywords but missing common variations'; it is above score 1 because the keyword is meaningful, and below score 3 because coverage of natural terms is thin.

2 / 3

Distinctiveness Conflict Risk

'Remotion React Markup' defines a fairly distinct niche unlikely to broadly conflict, but it overlaps with the cross-referenced 'remotion-best-practices' skill, matching 'somewhat specific but could still overlap with similar skills'; not score 1 because the niche is clear, not score 3 because the overlap with a sibling skill keeps some conflict risk.

2 / 3

Total

8

/

12

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 28 missing, 2 suspicious

Warning

Total

14

/

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.