CtrlK
BlogDocsLog inGet started
Tessl Logo

docs

Start the Remotion docs site and open it in the Codex browser. Use when the user invokes /docs or $docs, asks to launch the local documentation site, or wants to preview docs changes in Docusaurus.

70

Quality

86%

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

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 simple-skill body: lean, fully executable, and clearly sequenced with sensible contingencies for port changes and missing browser tooling. The only meaningful gap is the absence of any failure-path guidance (build errors, server startup errors), which keeps workflow clarity just below the top anchor.

DimensionReasoningScore

Conciseness

The body is ~20 lean lines with two short executable commands and zero padding: "bun i && bun run build", "cd packages/docs && bun run start". It assumes Claude's competence throughout (no explanation of what Docusaurus, bun, or a dev server is), and every line is an instruction or a useful contingency. This matches the 'lean and efficient; every token earns its place' anchor and is well above anchor 4, where minor over-explanation would remain.

5 / 5

Actionability

All guidance is copy-paste executable: exact commands for install/build and server start, the expected URL ("http://localhost:3000") with a rule for following the printed port, and a concrete tool-discovery instruction ("use tool_search for the in-app browser control tool"). Specific instructions cover the common cases end-to-end; nothing is pseudocode or merely described, which distinguishes it from anchor 4's 'minor gaps'.

5 / 5

Workflow Clarity

The five steps are clearly sequenced and include useful checkpoints — step 3 says to keep the process running and read its output for the actual URL (with a fallback if the port differs), and step 4 has a fallback if no browser tool is available. It stops short of anchor 5 because there are no explicit validation or error-recovery steps (e.g., what to do if the build fails or the server exits), though as a non-destructive single-site launch it does not hit the destructive/batch cap of 3.

4 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, needs no external references, and is organized into clean Overview and Workflow sections; per the rubric's guidance for simple skills this matches the top anchor. No bundle directories (references/, scripts/, assets/) exist and the body references none, so there is no nesting or buried-reference problem that would lower it.

5 / 5

Total

19

/

20

Passed

Description

78%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 strong, well-structured description that answers both 'what' and 'when' explicitly with natural trigger phrases including the exact slash command. Its main weakness is breadth: it names only the two most visible actions and leaves out the monorepo build and server-start steps that the skill actually performs, and its trigger list relies on the generic word 'docs' for some coverage.

Suggestions

Add one or two more concrete actions to the 'what' clause, e.g. "Installs and builds the Remotion monorepo, starts the Docusaurus docs server, and opens the served URL in the Codex in-app browser" to reach comprehensive coverage.

Broaden trigger synonyms toward the natural variations a user might say, such as "open the docs", "run the docs server", or "documentation site".

Consider naming the expected URL/port expectation or the package location (packages/docs) to further sharpen distinctiveness from generic documentation-preview skills.

DimensionReasoningScore

Specificity

The description names the domain ("Remotion docs site") and exactly two concrete actions ("Start the Remotion docs site and open it in the Codex browser"), which matches the anchor for naming a domain with 1-2 concrete actions but not comprehensive coverage. It is above anchor 2 because the actions are concrete rather than generic, but below anchor 4 because it omits supporting steps it actually performs (installing/building the monorepo, reading the server URL, reporting status) and lists only two actions.

3 / 5

Completeness

Both parts are explicit: the 'what' is concrete ("Start the Remotion docs site and open it in the Codex browser") and the 'when' is an explicit multi-phrase "Use when..." clause covering slash-command invocation, launching, and previewing changes. This matches the anchor that clearly and explicitly answers both what and when with concrete trigger phrases; the 'what' is not vague (which would drop it to 4) and the 'when' is not merely implied (which would cap it at 3).

5 / 5

Trigger Term Quality

Good keyword coverage with several natural trigger phrases: "/docs", "$docs", "launch the local documentation site", "preview docs changes", "Docusaurus" — these are phrases a user would plausibly say. It falls short of anchor 5's comprehensive synonym/extension coverage (e.g., "open the docs", "docs server", "documentation preview", "run the docs site"), but is clearly above anchor 3 because multiple distinct natural phrasings and the exact slash-command names are present.

4 / 5

Distinctiveness Conflict Risk

Proper nouns ("Remotion", "Docusaurus", "Codex browser") and the specific /docs command give it a mostly distinct niche with minimal conflict risk. It is below anchor 5 only because phrases like "launch the local documentation site" and "docs" are generic enough to overlap with documentation-preview skills in other repositories; it is well above anchor 3 since the environment-specific nouns disambiguate it.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.