CtrlK
BlogDocsLog inGet started
Tessl Logo

remotion-best-practices

Best practices for Remotion - Video creation in React

55

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/remotion-best-practices/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%

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 admirably lean, well-organized index into per-topic rule files with a clear When/How framing. Its main weakness is that it delegates all executable guidance to rule files that are not actually present in the bundle, so progressive disclosure and inline actionability fall short.

Suggestions

Ship the referenced rules/*.md bundle files so the one-level-deep navigation actually resolves.

Add a small inline quick-start example (e.g. a minimal Remotion composition and render command) so the skill is actionable without opening a rule file.

Group the 30 rule links into thematic clusters (setup, media, animation, captions, charts/maps) to improve discovery beyond a flat alphabetical list.

DimensionReasoningScore

Conciseness

The body is a lean index of one-line pointers with no padding and no explanation of what Remotion/React is, fully assuming Claude's competence; every token earns its place.

3 / 3

Actionability

It gives concrete pointers to specific rule files but provides no executable code or commands inline, leaving the actionable detail one level away; this is 'Some concrete guidance but incomplete' rather than copy-paste-ready 3.

2 / 3

Workflow Clarity

As a simple lookup skill the single action (locate the relevant rule file under When-to-use/How-to-use) is unambiguous and well organized; no destructive or batch operations require validation checkpoints, so it qualifies for 3 under the simple-skills note.

3 / 3

Progressive Disclosure

The SKILL.md is structured as a one-level-deep reference index, but the referenced rules/*.md files do not exist (no rules/, references/, scripts/, or assets/ bundle is present), so the navigation is signposted yet points to missing files, capping it at 2 rather than the clean well-signaled case at 3.

2 / 3

Total

10

/

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 identifies the Remotion/React video niche but is thin: it states the domain without listing concrete capabilities and lacks an explicit 'Use when...' trigger. It is functional but not comprehensive enough to score at the top of the scale.

Suggestions

Add concrete actions, e.g. 'Author compositions, sequence animations, embed audio/video, and render React components to video using Remotion.'

Append an explicit trigger clause, e.g. 'Use when working with Remotion code, rendering React components to video, or composing animations.'

Broaden natural trigger terms to include common phrasings like 'render React to video', 'Remotion composition', and 'video animation'.

DimensionReasoningScore

Specificity

Names the domain ('Remotion', 'Video creation in React') but lists no concrete actions, matching the 'Names domain and some actions, but not comprehensive' anchor rather than the multi-action list required for 3.

2 / 3

Completeness

It states what the skill covers ('Best practices for Remotion - Video creation in React') but has no explicit 'Use when...' trigger clause, which the guidelines cap at 2.

2 / 3

Trigger Term Quality

'Remotion', 'Video creation', 'React' are relevant keywords a user might say, but coverage lacks common variations like 'render', 'React video components', or 'animation'; 'best practices' is generic, so it sits at 'Some relevant keywords but missing common variations' rather than full coverage at 3.

2 / 3

Distinctiveness Conflict Risk

'Remotion' is a distinctive niche, but the generic 'best practices' wrapper and absence of explicit trigger phrases leave it plausibly overlapping with general React/video skills, so it is 'Somewhat specific but could still overlap' rather than the clear distinct-trigger case at 3.

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

Warning

Total

14

/

16

Passed

Repository
dtsola/xiaoyaosearch
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.