CtrlK
BlogDocsLog inGet started
Tessl Logo

remotion-best-practices

Router for all Remotion skills

60

Quality

72%

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

Quality

Content

96%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 router: lean, fully actionable, with clear dispatch conditions and well-signaled one-level-deep references. The only defect is that the referenced sub-skill files are absent from the provided bundle, so the routing targets cannot be verified.

DimensionReasoningScore

Conciseness

Each of the 12 routing sections is 1–2 lines of pure dispatch instruction with no concept explanations Claude already knows (no explanation of what Remotion or rendering is). The one explanatory clause ("By structuring the Remotion markup well, we can allow users to interactively change things in the Studio") exists to signal when that section applies, so every token earns its place — matching the 'Lean and efficient' anchor.

5 / 5

Actionability

Every section pairs a concrete condition ("If the user asks to make, create, or build a new video", "For static maps, animated routes and markers") with an exact action ("load [Create a new Remotion video](./remotion-create/SKILL.md)"). This is fully executable guidance for a router; per the scoring notes, absence of code in an instruction-only skill is not penalized when the guidance is this specific.

5 / 5

Workflow Clarity

The dispatch conditions are unambiguous and even handle edge cases ("whether or not a Remotion project already exists", "If no Remotion project currently exists"), plus a behavioral guard ("don't overwrite it, assume it was intentional or ask for confirmation"). As a single-purpose router with no destructive or batch operations, it meets the simple-skill exception for a top score.

5 / 5

Progressive Disclosure

The structure is textbook progressive disclosure — a concise overview with clearly signaled, one-level-deep references per topic — but scoring against the actual bundle shows none of the 12 referenced sub-skill files (./remotion-create/SKILL.md, ./remotion-markup/SKILL.md, etc.) exist in the bundle (only assets/remotion-icon.svg). This matches 'Good structure; most content is appropriately placed; references mostly clear; minor organization gaps' rather than a 5, since the navigation targets cannot be verified as present.

4 / 5

Total

19

/

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 is extremely terse: it identifies the niche (Remotion) and role (router) but names no concrete capabilities, no trigger conditions, and no synonym terms. It is distinguishable from other skills only by the word "Remotion", and a user or model reading it alone would not know when to invoke this versus a sub-skill.

Suggestions

Enumerate the concrete routing targets, e.g. "Routes Remotion work — new videos, project setup, React markup, maps, captions, rendering, Studio, SaaS/Lambda — to the matching sub-skill."

Add an explicit trigger clause, e.g. "Use when the user mentions Remotion, rendering videos with React, compositions, <Player>, or Remotion Studio/Lambda."

Include natural synonym trigger terms users actually say (video, composition, render, programmatic video, Remotion Studio) alongside "Remotion" to improve trigger-term coverage.

DimensionReasoningScore

Specificity

The description is only "Router for all Remotion skills" — it names the domain (Remotion) but the only action named is the generic "Router". It matches the anchor 'Names the domain but actions are minimal or generic' (e.g. "Processes PDF files"), and is not entirely vague (score 1) because it does pin a concrete domain and role.

2 / 5

Completeness

The 'what' is stated at a high level (it routes among Remotion skills) but there is no 'when' clause at all — no 'Use when...' or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It does not reach score 4 because the 'what' is also thin, naming no concrete capabilities.

3 / 5

Trigger Term Quality

"Remotion" is a distinctive, natural keyword a user would say, but it is essentially the only trigger term; there are no variations or synonyms like video, composition, render, or React video. This fits 'Some relevant keywords but missing common variations or synonyms'; it is above score 2 because "Remotion" is highly specific rather than generic.

3 / 5

Distinctiveness Conflict Risk

"Remotion" carves out a clear niche with minimal conflict risk against unrelated skills, matching 'Mostly distinct; minor overlap risk with closely related skills'. It falls short of score 5 because the description gives no explicit trigger phrases to distinguish this router from the individual Remotion sub-skills it dispatches to.

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: 12 missing

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.