CtrlK
BlogDocsLog inGet started
Tessl Logo

remotion-best-practices

Best practices for Remotion - Video creation in React

56

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

Quality

Content

92%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 progressive-disclosure hub: lean, well-organized, and unambiguous about which rule file to load for which task. Its only real gap is that all executable content lives in the referenced files rather than inline, which is appropriate for a best-practices router.

DimensionReasoningScore

Conciseness

The body is a lean routing index where every line points to a rule file with a one-line scope note; it assumes Claude's competence and explains nothing Remotion-generic. Only the slightly padded opener ('Use this skills whenever you are dealing with Remotion code to obtain the domain-specific knowledge') could be trimmed, which is too minor to drop from anchor 5's 'every token earns its place'.

5 / 5

Actionability

Per the scoring notes, absence of code is not penalized when guidance is actionable, and it is: explicit directives like 'load the [./rules/subtitles.md] file' for captions and a task-to-file map covering ~30 topics. It is not 5 because all executable substance is one hop away — the body itself contains no code, commands, or inline patterns for even the most common cases.

4 / 5

Workflow Clarity

This is a simple single-purpose router skill (under 50 lines of body, one task), and the single action — consult the matching rule file before writing Remotion code — is unambiguous via the 'When to use' section, three proactively highlighted rules, and a fully described index. No destructive or batch operations, so the validation cap does not apply.

5 / 5

Progressive Disclosure

A textbook hub: a concise overview body with clearly signaled, one-level-deep references, each carrying a descriptive label for discovery. Minor nits (inconsistent './rules/' vs 'rules/' path prefixes; subtitles/ffmpeg/audio-visualization appearing only in prose sections rather than the index) do not impede navigation, so it holds anchor 5 rather than 4.

5 / 5

Total

19

/

20

Passed

Description

40%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 its niche but tells neither Claude nor the user what the skill actually does or when to invoke it. It is a domain label plus generic 'Best practices' filler with no capabilities enumerated and no trigger guidance.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when working with Remotion compositions, rendering videos in React, or when the user mentions Remotion or programmatic video.'

Replace 'Best practices' with 2-4 concrete capabilities drawn from the body, e.g. 'animation timing and springs, captions/subtitles, audio visualization, video embedding and trimming, FFmpeg operations'.

Include natural trigger synonyms and variations such as 'video rendering', 'motion graphics in React', and '@remotion' to improve keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Best practices for Remotion - Video creation in React') but lists no concrete actions — 'Best practices' is generic filler. It is not a 1 because the domain itself (Remotion, React video) is specifically named rather than purely abstract.

2 / 5

Completeness

There is no 'Use when...' clause or equivalent trigger guidance, and the 'what' is itself vague ('Best practices' describes no capability). This fits anchor 2 ('Has a vague what and no when') and cannot be 3 because the what is not concrete or clear.

2 / 5

Trigger Term Quality

'Remotion', 'video', and 'React' are terms users would naturally say, but common variations and synonyms ('video rendering', 'programmatic video', 'motion graphics', 'animate') are missing. This matches 'Some relevant keywords but missing common variations or synonyms' rather than 4's 'a few natural terms missing' — coverage is only the bare domain name.

3 / 5

Distinctiveness Conflict Risk

'Remotion' names a specific library, giving a clear niche with minimal conflict risk, but the trailing 'Video creation in React' is broad and could overlap with generic React video/multimedia skills. It is mostly distinct with minor overlap risk (anchor 4), not 5, because no trigger phrases sharply delineate it.

4 / 5

Total

11

/

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

Warning

Total

14

/

16

Passed

Repository
gooseworks-ai/goose-skills
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.