CtrlK
BlogDocsLog inGet started
Tessl Logo

interactivity-best-practices

Best practices for writing Remotion animations that stay intuitive for agents and editable in Remotion Studio Visual Mode.

48

Quality

51%

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 ./.agents/skills/interactivity-best-practices/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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 minimal redirect to two external docs rather than a self-contained skill, offering little actionable guidance and relying on paths that do not resolve within the bundle.

Suggestions

Add a brief actionable summary of the key best practices inline so the skill remains useful even when the linked docs are unavailable.

Verify the referenced .mdx paths resolve within the skill's context; the relative paths currently point outside the skill bundle and appear not to exist.

Clarify when to consult each referenced doc with a one-line distinction between the best-practices page and the make-component-interactive guide.

DimensionReasoningScore

Conciseness

The body is extremely lean with no concept over-explanation or padding, though the "Use the canonical ... instead:" framing is slightly redundant, placing it just below the maximally-efficient anchor.

4 / 5

Actionability

It offers only high-level pointers ("use [this doc]") with no concrete executable guidance or steps, and the referenced paths do not resolve, matching the minimal-concrete-guidance anchor.

2 / 5

Workflow Clarity

The two referenced docs are unsequenced parallel links with no validation checkpoints; the redirect intent is clear but there is no real workflow sequence.

3 / 5

Progressive Disclosure

The two references are clearly signaled and one level deep, but the skill provides no overview content of its own and the referenced paths lie outside the bundle and do not resolve.

3 / 5

Total

12

/

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.

The description states a clear, niche purpose but lacks an explicit trigger clause and comprehensive capability/action listing, landing it in the middle of the scale.

Suggestions

Add an explicit "Use when..." clause naming the trigger conditions (e.g., writing or reviewing Remotion animations for Visual Mode) to raise completeness and distinctiveness.

Include more natural trigger terms and synonyms such as "Remotion Studio", "interactive components", and "Visual Mode".

List one or two more concrete capabilities (e.g., "structuring interactive props", "naming animation sequences") to improve specificity.

DimensionReasoningScore

Specificity

Names the domain ("Remotion animations") plus a couple of concrete attributes ("intuitive for agents", "editable in Remotion Studio Visual Mode"), but the action list is not comprehensive, matching the anchor for naming a domain with 1-2 concrete actions.

3 / 5

Completeness

It clearly states what the skill covers but has no "Use when..." trigger clause, so completeness is capped at 3 per the missing-trigger-guidance rule.

3 / 5

Trigger Term Quality

"Remotion animations" and "Remotion Studio Visual Mode" are natural terms a user might say, but common variations/synonyms (e.g., "interactive components", "Studio") are missing, fitting the some-relevant-keywords-but-missing-variations anchor.

3 / 5

Distinctiveness Conflict Risk

The Remotion + Visual Mode + agent-intuitive niche is clearly distinct with minimal overlap risk, but the absence of explicit trigger phrasing keeps it below the 5 anchor.

4 / 5

Total

13

/

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