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.

44

Quality

46%

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

35%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is essentially a bare redirect to two external documentation files that are not present anywhere in the environment, with no inline guidance. It is unusable as written because the referenced destinations do not resolve.

Suggestions

Inline at least a minimal quick-start set of concrete best practices (e.g. a sample interactive component snippet) so the skill is usable without external docs.

Either copy the referenced MDX docs into references/ and link to them bundle-relative, or replace the ../../../packages/docs/... paths with links that actually resolve within the skill bundle.

Add concrete, executable guidance — code patterns or specific property conventions — instead of only pointing the reader elsewhere.

DimensionReasoningScore

Conciseness

The body is terse with no padding, but its tokens are redirect links to nonexistent paths, so they do not truly earn their place by delivering usable content.

2 / 3

Actionability

There is no executable code or concrete command; the body only says where to go ('Use the canonical... page instead') rather than instructing how to do anything.

1 / 3

Workflow Clarity

Two destinations are each signaled with their purpose, but both links are dead (pointing outside the bundle), with no sequencing or validation guidance for when to use which.

2 / 3

Progressive Disclosure

The references are one level deep and signaled, but there is no overview content and the targets are repo-relative paths outside the skill that do not exist.

2 / 3

Total

7

/

12

Passed

Description

57%

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 clearly scopes a specific Remotion niche but stays abstract, listing no concrete actions and omitting any explicit 'Use when' trigger. It is distinguishable from other skills yet incomplete as activation guidance.

Suggestions

Add a 'Use when...' clause with explicit triggers, e.g. 'Use when writing or reviewing Remotion animations and components for Studio Visual Mode, or when making elements interactive.'

Replace 'Best practices for writing' with concrete actions, e.g. 'Add click/hover handlers, structure props for Visual Mode, keep components agent-editable.'

Include natural trigger terms users would actually say — 'interactive components', 'click and hover', 'Visual Mode animation' — alongside 'Remotion animations'.

DimensionReasoningScore

Specificity

It names the domain and goals ('Remotion animations', 'editable in Remotion Studio Visual Mode') but 'Best practices for writing' is abstract, with no concrete actions listed as the score-3 anchor requires.

2 / 3

Completeness

It states what the skill covers but provides no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 2 per the rubric.

2 / 3

Trigger Term Quality

'Remotion animations' and 'Remotion Studio Visual Mode' are natural keywords, but coverage is narrow and omits common variations like 'interactive components', 'click/hover', or 'interactivity'.

2 / 3

Distinctiveness Conflict Risk

The Remotion + Studio Visual Mode framing is a clear, narrow niche with distinct triggers, making it unlikely to fire for unrelated skills.

3 / 3

Total

9

/

12

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.