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.

72

Quality

88%

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.

A tight, highly actionable skill body that gives concrete commands, syntax, and conventions for Remotion documentation authoring with a clear add-a-page workflow and a build-validation step. It is economical with tokens and well-organized for a single-file overview.

DimensionReasoningScore

Conciseness

Lean and imperative throughout ("Developers don't like to read. Extra words cause information loss."), with no padding or explanations of concepts Claude already knows, matching the 'every token earns its place' anchor; not 4 because there is no noticeable over-explanation to trim.

5 / 5

Actionability

Provides concrete, copy-paste-ready guidance: exact commands ("bun render-cards.ts", "bun run build-docs"), specific syntax ("```ts twoslash", "// ---cut---"), heading conventions ("### for top-level", "#### for nested"), and component usage with fenced examples, matching the fully-executable anchor; not 4 because coverage of common cases is complete with only negligible gaps.

5 / 5

Workflow Clarity

The "Adding a new page" section gives a clear 4-step sequence and a dedicated "Verifying docs compile" validation command, matching the 'clear sequence with most checkpoints present' anchor; not 5 because an explicit validate->fix->retry feedback loop is not spelled out, and not 3 because validation is present (the destructive/batch cap does not apply to additive doc authoring).

4 / 5

Progressive Disclosure

Single self-contained SKILL.md with no bundle files and clean, well-signaled section headers, matching the simple-skill exception ('under 50 lines with no need for external references ... can score 5 with just well-organized sections'); not 4 because nothing is buried or mis-placed and navigation via headers is unambiguous.

5 / 5

Total

19

/

20

Passed

Description

83%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 well-crafted description that clearly states the skill's purpose and provides explicit, natural trigger conditions for the Remotion documentation authoring niche. It is concise, third-person, and avoids vague language or over-claims.

DimensionReasoningScore

Specificity

Names the domain ("writing and editing Remotion documentation") and several concrete actions ("adding docs pages", "editing MDX files in packages/docs"), matching the 'several specific actions; minor gaps' anchor; not 5 because it stops short of a comprehensive multi-action list, and not 3 because it clearly exceeds 1-2 actions.

4 / 5

Completeness

Explicitly answers both 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 top anchor; not 4 because the 'when' is fully explicit rather than improvable.

5 / 5

Trigger Term Quality

Includes natural terms users would say ("docs pages", "MDX files", "documentation content", "packages/docs") matching the 'good keyword coverage; a few natural terms missing' anchor; not 5 because synonyms/extensions beyond .mdx are absent, and not 3 because coverage is broader than a single phrase.

4 / 5

Distinctiveness Conflict Risk

Targets a clear niche (Remotion docs authoring, MDX in packages/docs) with distinct triggers and low overlap risk, matching the 'mostly distinct; minor overlap risk' anchor; not 5 because it could still weakly overlap with general documentation-writing skills.

4 / 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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository
foryourhealth111-pixel/Vibe-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.