CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

remotion-saas

Build an app with Remotion

Quality

52%

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/codex-plugin/skills/remotion-saas/SKILL.md

The canonical home for this skill is remotion-saas in remotion-dev/skills

SKILL.md
Quality
Evals
Security

Quality

Content

43%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 a token-lean topic index with clean section structure, but it contains no executable guidance and its three local references point to files missing from the bundle, leaving the Vue/Angular/Svelte sections as the only resolvable pointers (to external URLs). As written, the skill tells Claude what topics exist but not how to do anything with them. The structure is the right shape for an overview skill; the substance is absent.

Suggestions

Ship the referenced files (framework.md, player.md, rendering.md) in the bundle or replace the dead links with inlined essential guidance — as delivered, every local link in the skill is broken.

Replace the filler intro with a minimal quick-start, e.g., a template clone command (`npx create-video@latest`) and a basic composition or <Player> snippet, so the body has at least one concrete, executable step.

Sequence the sections as an explicit build workflow (choose template → build composition → preview with Player → choose a rendering target) with a verification step such as running a local render (`npx remotion render`) to confirm the output before deploying.

DimensionReasoningScore

Conciseness

The body is dominated by lean one-line section links, but the opening ("One can build apps with Remotion. It is possible to have a simple form and hook it up to a render, or have a complex video editor.") is trimmable filler that neither instructs nor adds anything Claude doesn't know. This is a minor, localized instance of padding, matching "Efficient; minor instances of over-explanation that could be trimmed" rather than score 3, where unnecessary explanation is more pervasive.

4 / 5

Actionability

There is no code, command, or concrete step anywhere in the body — every section is a pointer such as "See [Choosing a framework](framework.md) for help choosing a template or framework", and the locally referenced files do not exist in the bundle. These are high-level hints without the specific steps to execute, matching score 2; not 1 because the pointers are at least topic-specific and would be followable if the files were present.

2 / 5

Workflow Clarity

The sections imply a rough progression (choose template/framework → Player preview → rendering → alternate frameworks) but no steps are actually listed, nothing is sequenced or numbered, and there are no checkpoints or validation. This matches "Rough sequence present but many gaps; steps poorly defined"; it cannot reach 3 because that anchor requires steps to be listed.

2 / 5

Progressive Disclosure

The written structure is the right shape — clearly signaled, one-level references such as "See [Player](player.md)" and "See [Rendering](rendering.md)" — but scoring against the actual bundle structure per the guideline, framework.md, player.md, and rendering.md do not exist (the bundle contains only assets/remotion-icon.png), so every local navigation target is broken and the skill is effectively an empty index. That falls below the 4 anchor ("references mostly clear" assumes they resolve); it stays at 3 rather than 2 because the overview's organization and signaling themselves are genuinely good and the Vue/Angular/Svelte sections do resolve to real external URLs.

3 / 5

Total

11

/

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 is a single short sentence that names the tool but says almost nothing about what the skill actually covers or when it should be used. It is distinct thanks to the Remotion name, but its lack of capabilities, natural trigger phrases, and any 'when' guidance leaves it weak. It resembles the vague "bad" examples more than the enumerated "good" ones.

Suggestions

Enumerate concrete capabilities in the description, e.g., "Scaffold Remotion apps from templates, embed video previews with the <Player> component, and set up client- or server-side rendering (Lambda, Vercel, Node.js, Cloudflare)."

Add an explicit trigger clause, e.g., "Use when the user mentions Remotion, building a programmatic video app, embedding a video player in React, or rendering React compositions to video."

Include natural synonyms users would actually say — "video", "programmatic video", "video editor", "render" — rather than the generic word "app".

DimensionReasoningScore

Specificity

The description names the domain ("Remotion") but the action is minimal and generic ("Build an app"), matching the anchor example "Processes PDF files". It does not enumerate any of the skill's actual capabilities (templates, Player, rendering options), so it falls short of the 3 anchor's "1-2 concrete actions".

2 / 5

Completeness

The "what" ("Build an app with Remotion") is itself vague — it doesn't say what kind of app or which capabilities — and there is no "when" clause whatsoever, matching the anchor "Has a vague 'what' and no 'when'". It cannot reach 3 because that anchor requires a clear 'what'; the guideline also caps completeness at 3 for a missing 'Use when...' clause, and the vague 'what' pushes it below that.

2 / 5

Trigger Term Quality

"Remotion" is the one strong natural keyword a user would say, but coverage stops there — "app" and "Build" are generic, and common phrasings like "video", "programmatic video", "render video", or "video player" are missing. Matches "Works with PDF files" (some relevant keywords, missing variations), not 4 which requires broader natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

Naming the niche tool "Remotion" makes it mostly distinct from other skills with only minor overlap risk from the generic "Build an app" phrasing, analogous to "Works with PDF and Word document files". Not 5: there are no explicit trigger phrases, so distinctiveness rests entirely on the tool name, and a generic app-development request could plausibly surface 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: 3 missing

Warning

Total

14

/

16

Passed

Repository

remotion-dev/remotion

Path

packages/codex-plugin/skills/remotion-saas/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.