CtrlK
BlogDocsLog inGet started
Tessl Logo

remotion-docs

Search Remotion documentation

61

Quality

73%

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

Quality

Content

93%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.

An exemplary short skill: a concrete, token-efficient recipe (Algolia search + `.md` fetch) with a clear workflow and no padding. The only improvement space is a brief fallback instruction for empty or poor search results.

DimensionReasoningScore

Conciseness

The body is ~40 lean lines with zero concept explanation (no 'what an API is', no library primers) — phrases like "Append `.md` to any Remotion docs URL to retrieve its Markdown source (saves tokens)" carry only operational value. Every section (search, fetch, workflow) earns its tokens; it fully assumes Claude's competence, matching the 'lean and efficient' anchor and clearly not the score-4 anchor's 'minor instances of over-explanation'.

5 / 5

Actionability

The Algolia snippet is a fully executable copy-paste HTTP request with a concrete endpoint, API key, index name, and params, and the fetch step gives three real example URLs ("https://www.remotion.dev/docs/use-video-config.md"). This matches the 'fully executable; copy-paste ready' anchor; it is not score 4 because there are no gaps in the common-case path (search → URL → fetch).

5 / 5

Workflow Clarity

The 4-step workflow ("1. Search Algolia… 2. Pick the most relevant URL(s)… 3. Fetch each URL with the `.md` suffix… 4. Implement using the current documentation") is a clear, correctly-sequenced loop matching the 'clear sequence with most checkpoints; minor validation gaps' anchor. It is not 5 because there is no checkpoint or feedback guidance for failure cases (e.g., zero or irrelevant search hits), and not 3 because the sequence is explicit and unambiguous rather than merely 'listed with implicit checkpoints'.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references (bundle contains only a decorative `assets/remotion-icon.svg`), and content is organized into three well-signaled sections ("## Searching the docs", "## Fetching a page as Markdown", "## Workflow") with one appropriate outbound pointer to the sibling best-practices skill. Per the rubric's simple-skill guidance this matches the top anchor; nothing that belongs in a separate file is inlined.

5 / 5

Total

19

/

20

Passed

Description

53%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.

A terse, distinctive description that clearly says what the skill does but omits any 'when to use' trigger guidance and most natural keyword variants, leaving it under-specified for reliable triggering. Adding a Use-when clause and common synonyms (docs, Remotion API, video rendering) would lift specificity, triggers, and completeness together.

Suggestions

Add an explicit trigger clause, e.g. "Use when working with Remotion APIs, components, or configuration and current documentation is needed rather than memorized knowledge."

Include natural keyword variants users would say — "Remotion docs", "Remotion API", "Remotion Lambda", video rendering — to improve trigger matching.

Mention the read/fetch capability (retrieving docs as Markdown) so the stated actions cover both halves of what the skill actually does.

DimensionReasoningScore

Specificity

"Search Remotion documentation" names the domain and one concrete action (search), matching the score-3 anchor 'Names domain and 1-2 concrete actions, but not comprehensive' (the body also covers fetching pages as Markdown, but per the guidelines I score only what is stated). It is not 4 because only one action is listed with no coverage of reading/fetching, and not 2 because 'Search' is a concrete action beyond the generic 'Processes PDF files' pattern.

3 / 5

Completeness

The 'what' is clear ("Search Remotion documentation") but there is no 'Use when…' clause or equivalent trigger guidance, so per the explicit guideline a missing when-clause caps completeness at 3 ('Has a clear what but when is missing or only weakly implied'). It is not 4 because nothing states when to invoke this skill versus the sibling best-practices skill, and not 2 because the what is concrete rather than vague.

3 / 5

Trigger Term Quality

"Remotion" is the key natural term and "documentation"/"search" are relevant, matching 'Some relevant keywords but missing common variations or synonyms' — users would often say "Remotion docs", "Remotion API", "Remotion Lambda", or component names like `<Sequence>`, none of which appear. It is not 4 because several natural phrasings users would actually say are absent, and not 2 because the unique product name 'Remotion' is far more informative than 'Works with files'.

3 / 5

Distinctiveness Conflict Risk

"Remotion" is a distinctive product name giving the description a clear niche with minimal conflict against unrelated skills, matching 'Mostly distinct; minor overlap risk with closely related skills'. It is not 5 because the sibling 'remotion-best-practices' skill shares the Remotion trigger surface — a user asking a general Remotion question could reasonably need either skill — and not 3 because 'Remotion documentation' is far more specific than 'Works with document files'.

4 / 5

Total

13

/

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: 1 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.