CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-docs

Guides for writing and editing Remotion documentation. Use when adding docs pages, editing MDX files in packages/docs, or writing documentation content.

68

Quality

82%

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

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

A well-crafted conventions skill: rules are stated tersely, each backed by a copy-paste-ready example, and the page-creation workflow is a concrete ordered list. The main improvement areas are de-duplicating the render-cards/AvailableFrom guidance, adding a post-edit validation step, and splitting the special-components reference detail out of SKILL.md.

DimensionReasoningScore

Conciseness

The body is a dense convention list with almost no explanation of concepts Claude already knows; every token-earning example sits next to its rule. Not a 5 because of minor redundancy — 'bun render-cards.ts' appears both in the new-page checklist and again in a dedicated section, and <AvailableFrom> guidance is spread across three sections. Not a 3 because there is no padded or unnecessary explanation anywhere.

4 / 5

Actionability

Guidance is fully executable: exact frontmatter blocks, twoslash fence examples with '---cut---' and title, the exact <CompatibilityTable> prop syntax, optional-parameter do/don't pairs, and a runnable command ('cd packages/docs && bun render-cards.ts'). Common cases are covered by copy-paste examples, matching the anchor-5 pattern; the anchor-4 'minor gaps' case does not apply.

5 / 5

Workflow Clarity

'Adding a new page' is a clearly ordered 4-step sequence (create file, update sidebars.ts, write content, run render-cards.ts) with concrete commands. Not a 5 because there is no validation checkpoint (no verify-build/lint step after edits) and no error-recovery loop; not a 3 because the sequence is explicit and this is not a destructive or batch operation, so the validation cap does not apply.

4 / 5

Progressive Disclosure

Single-level, well-signaled sections with clean headers and no nested references (the only external pointer, 'See the docs-demo skill', targets a sibling skill, not a chained file). Not a 5 because at ~215 lines the detailed special-components documentation (<CompatibilityTable> props, AvailableFrom variants) is inline and could be split into a reference file; not a 3 because the structure is good and nothing is buried.

4 / 5

Total

17

/

20

Passed

Description

82%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 description: third-person, concise, with an explicit 'Use when' clause containing concrete, repo-specific triggers. Its only weakness is that the 'what' half stays at the generic level of 'writing and editing' rather than listing the specific documentation tasks the skill actually covers.

DimensionReasoningScore

Specificity

The description names the domain ('Remotion documentation') and two concrete actions ('writing and editing'), but does not enumerate several specific actions like the anchor-4 example ('Extracts text... fills forms, converts pages'). It clearly exceeds anchor 2 because the domain is named precisely and actions are concrete rather than generic.

3 / 5

Completeness

Explicitly answers what ('Guides for writing and editing Remotion documentation') and when ('Use when adding docs pages, editing MDX files in packages/docs, or writing documentation content') with concrete trigger phrases, matching the anchor-5 pattern. It is not a 4 because the 'when' clause is already specific and multi-trigger.

5 / 5

Trigger Term Quality

Includes natural phrases a user would say — 'adding docs pages', 'editing MDX files in packages/docs', 'writing documentation content'. Not a 5 because some synonyms and extensions (e.g. '.mdx', 'docusaurus', 'docs' alone) are absent; not a 3 because coverage goes beyond one generic keyword with concrete repo-specific terms.

4 / 5

Distinctiveness Conflict Risk

'Remotion documentation' plus the repo-specific 'MDX files in packages/docs' carves out a clear niche with distinct triggers and minimal conflict risk with other skills. Nothing pushes it toward the anchor-4 'minor overlap' case.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 4 suspicious

Warning

Total

15

/

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.