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.

55

Quality

62%

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

71%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 maximally token-efficient and unambiguous as a router, with one concrete technical rule (include Interactive.baseSchema). Its weakness is that almost all substance lives in external repo documents that are not part of the skill bundle, and the one actionable rule ships without a code example.

Suggestions

Add a short copy-paste code example of a correct `Interactive.withSchema()` schema that includes `Interactive.baseSchema`, so the rule is executable without leaving the skill.

Ship the referenced guidance inside the skill bundle (e.g. references/interactivity-best-practices.md) or summarize its key rules inline, since the current .mdx paths lie outside the bundle and may not resolve.

Sharpen the routing conditions — one line each stating when to consult the canonical best-practices page versus make-component-interactive.mdx.

DimensionReasoningScore

Conciseness

The body is six lines with zero padding, no explanation of concepts Claude already knows, and no fluff — every line either routes to a doc or states one concrete rule. Matches the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

It provides two concrete file paths to open and one specific, testable instruction ("include `Interactive.baseSchema` in the schema"), but there is no executable code example showing a correct `Interactive.withSchema()` schema, and the main guidance is 'go read this other file'. Not score 2 because the paths and the baseSchema rule are genuinely concrete; not score 4 because the key schema guidance lacks any code or command.

3 / 5

Workflow Clarity

As a simple routing skill, the single action is largely unambiguous: use the canonical page for best practices, use make-component-interactive.mdx for making elements interactive, and apply the baseSchema rule when using withSchema(). Not score 5 because the routing condition for the two documents is only loosely specified (which situations send you to which page is not sharply delineated), and the baseSchema rule has no error-recovery context.

4 / 5

Progressive Disclosure

References are one level deep and clearly signaled with full paths, but the body contains no overview content of its own and delegates everything to files outside the skill bundle — the referenced .mdx paths do not exist within the bundle (no references/, scripts/, or assets/ directories), so the skill is effectively pure indirection with no in-bundle fallback. Not score 2 because the references are explicit and not buried; not score 4 because there is no in-bundle content or structure backing the pointers.

3 / 5

Total

15

/

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 is concise, accurately scoped, and clearly distinct within the Remotion niche, but it reads as a topic label rather than a capability+trigger statement. It lacks any 'Use when...' trigger guidance and misses natural trigger synonyms like 'interactivity' or 'interactive components'.

Suggestions

Add an explicit trigger clause, e.g. 'Use when writing interactive or clickable elements, custom components with Interactive.withSchema(), or animations meant to be edited in Remotion Studio Visual Mode.'

Include the natural synonyms users would say — 'interactivity', 'interactive components', 'click/hover events', 'timeline controls' — alongside 'Remotion animations' to improve trigger term coverage.

State the concrete capability the skill delivers (routing to the canonical best-practices and make-component-interactive guides plus the baseSchema rule) so the 'what' is an action, not just a topic.

DimensionReasoningScore

Specificity

The description names the domain clearly ("writing Remotion animations", "Remotion Studio Visual Mode") and includes two concrete qualifiers — "stay intuitive for agents" and "editable in Remotion Studio Visual Mode" — but it is a topic statement rather than a list of concrete actions like extract/fill/merge. Not score 2 because the domain is precisely qualified, not generic; not score 4 because no multiple specific actions are enumerated.

3 / 5

Completeness

It has a clear 'what' ("Best practices for writing Remotion animations that stay intuitive for agents and editable in Remotion Studio Visual Mode") but no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guidelines. Not score 4 because the 'when' is entirely absent rather than just under-specified.

3 / 5

Trigger Term Quality

Relevant keywords are present ("Remotion", "animations", "Remotion Studio", "Visual Mode", "agents"), but common variations a user would naturally say are missing — notably "interactivity/interactive", "interactive components", "click/hover handlers", and "timeline". Not score 4 because the coverage lacks synonyms beyond the single product-name phrasing; not score 2 because the terms present are domain-accurate and natural, not generic.

3 / 5

Distinctiveness Conflict Risk

The niche is clear and product-specific (Remotion + Studio Visual Mode), so it is unlikely to trigger for unrelated skills; however, without explicit trigger phrases it could overlap with sibling Remotion skills (e.g., general Remotion animation or Studio docs skills). Not score 5 because distinct triggers are not spelled out; not score 3 because the domain scoping is much tighter than the anchor-3 examples.

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.

Validation — 15 / 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.