CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

remotion-best-practices

Best practices for Remotion - Video creation in React

Quality

63%

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 ./skills/remotion-best-practices/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 SKILL.md body is a clean, token-efficient index with excellent per-rule scoping labels, but it delegates 100% of the actual guidance to rules/*.md files that are missing from the bundle, leaving the skill with no usable content and every reference dead-ending. Adding a minimal inline quick-start and shipping the rule files would resolve the main gaps.

Suggestions

Ship the rules/*.md files in the skill bundle — all 28 referenced paths are absent, so every link in the index dead-ends and the skill delivers no guidance on its own.

Add a brief inline quick-start (e.g. one minimal composition with useCurrentFrame() interpolation) or a 'most common rules' callout so the skill is actionable without opening a rule file.

Group the 28 rule links by category (e.g. media, animation/interpolation, captions/text, tooling) and trim the filler phrase 'to obtain the domain-specific knowledge' from the When to Use section.

DimensionReasoningScore

Conciseness

The body is a lean ~35-line index: one 'When to Use' sentence ('Use this skills whenever you are dealing with Remotion code') plus a 28-item list where each line earns its place. Only minor trim candidates exist, e.g. the filler phrase 'to obtain the domain-specific knowledge' — this matches anchor 4 ('efficient; minor instances that could be trimmed') rather than 5, and is far from the verbose anchor 1 pattern of explaining concepts Claude already knows.

4 / 5

Actionability

The guidance is concrete at the navigation level ('Read individual rule files for detailed explanations and code examples') with a specific file and one-line scope per topic (e.g. 'rules/trimming.md - Trimming patterns for Remotion - cut the beginning or end of animations'), but there is no executable code, command, or quick-start inline, and none of the referenced rules/*.md files exist in the bundle, so the instruction cannot actually be executed. This sits at anchor 3 ('some concrete guidance but incomplete; missing key details'), below anchor 4 whose guidance is executable end-to-end.

3 / 5

Workflow Clarity

As a simple single-action skill the sequence is clear: trigger on 'dealing with Remotion code', then read the rule file matching the task — each list entry maps a concrete scenario to a file, making the single action mostly unambiguous. It falls short of 5 because with 28 undifferentiated entries, no prioritization or quick-start pointer, and referenced files that are absent, the workflow dead-ends; no validation steps are needed since this is a non-destructive reference skill.

4 / 5

Progressive Disclosure

Structurally the body is a textbook overview: 'Read individual rule files...' followed by 28 clearly signaled, one-level-deep references each with a descriptive label. However, scoring against the actual bundle, none of the 28 referenced rules/*.md files (nor any references/, scripts/, or assets/ directories) exist — every link is broken, so the disclosure structure is only nominal and navigation is unverifiable. This lands at anchor 3: good structure on paper, significant reference gaps in practice, below anchor 4 where content is appropriately placed and references actually resolve.

3 / 5

Total

14

/

20

Passed

Description

48%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 identifies the domain unambiguously (Remotion, video creation, React) and is pleasantly concise, but it states no concrete capabilities and completely lacks a 'Use when' trigger clause, so it under-communicates both what the skill does and when to invoke it. It reads more like a title than an actionable skill description.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when creating, debugging, or rendering videos with Remotion or when the user mentions Remotion, programmatic video, or rendering video from React components.'

Replace the generic 'Best practices' frame with 2-3 concrete capabilities, e.g. 'Create video compositions in React: animations and springs, audio syncing, captions, transitions, and asset handling.'

Add natural trigger synonyms users actually say — 'render video', 'programmatic video', 'make videos with code', 'motion graphics' — to improve keyword coverage.

DimensionReasoningScore

Specificity

The description 'Best practices for Remotion - Video creation in React' names the domain clearly but lists no concrete actions — 'Best practices' is a generic frame with no verbs like 'create compositions', 'sync audio', or 'add transitions'. This matches anchor 2 ('Names the domain but actions are minimal or generic', e.g. 'Processes PDF files') rather than anchor 3, which requires 1-2 explicitly stated concrete actions.

2 / 5

Completeness

There is a recognizable 'what' (best practices for video creation in React using Remotion) but no 'Use when...' clause or equivalent trigger guidance anywhere in the description, which per the judging guidelines caps completeness at 3 ('Has a clear what but when is missing'). It is above anchor 2 because the 'what' is not vague — the domain and purpose are explicit.

3 / 5

Trigger Term Quality

It includes the strong natural terms 'Remotion', 'Video', and 'React', which users of the tool will say, but misses common variations and synonyms such as 'render', 'programmatic video', 'make videos with code', or 'motion graphics'. This matches anchor 3 ('Some relevant keywords but missing common variations or synonyms') rather than anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

'Remotion' is a distinctive proper noun giving this a clear niche with minimal conflict risk, but the broader clause 'Video creation in React' overlaps slightly with generic React animation or video-embedding skills, matching anchor 4 ('Mostly distinct; minor overlap risk with closely related skills') rather than anchor 5, whose triggers are fully distinct.

4 / 5

Total

12

/

20

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.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 28 missing

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/remotion-best-practices/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.