CtrlK
BlogDocsLog inGet started
Tessl Logo

add-sfx

Add a new sound effect to @remotion/sfx

54

Quality

61%

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/add-sfx/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 content is a tight, highly actionable procedure: concrete commands, exact code-entry shapes, and explicit step ordering. Its main weakness is the total absence of validation/verification checkpoints — particularly around the batch waveform regeneration and the final build — and the vague "Deploy" step.

Suggestions

Add validation checkpoints, e.g. after step 5 confirm the new entry appears in `packages/docs/components/sfx-demos/sfx-waveforms.ts`, and after step 7 verify the export resolves / build output before finishing.

Replace the bare "Deploy" instruction in step 1.4 with the actual command or a pointer to the repo's deploy procedure.

Replace step 3's nine-item checklist with a concrete skeleton `.mdx` (or a bundled reference file modeled on `whip.mdx`) so the doc page is copy-paste ready like the other steps.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout — "Add the WAV file to the root of the repo", "Run `bun generate.ts`", "Use camelCase for the variable name" — with no explanations of concepts Claude already knows. It is not a 5 because a few sentences ("The `.env` may be missing if we are in a worktree, but on the main non-worktree branch it should be present") are tangential asides that don't earn their place on every invocation.

4 / 5

Actionability

Most steps give executable, copy-paste-ready material: `bun generate.ts`, the exact `soundEffects` entry shape, `bun packages/docs/generate-sfx-waveforms.ts`, `cd packages/sfx && bun run make`, plus a naming table. Not a 5: step 1.4 says only "Deploy" with no command, and step 3 is a checklist of required doc elements without a concrete example to copy.

4 / 5

Workflow Clarity

Seven explicitly ordered steps with a clear dependency constraint ("### 1. Add to `remotion.media` repo (must be done first)") give a complete sequence, but there are no validation or verification checkpoints anywhere. Per the rubric guideline, the waveform regeneration in step 5 is a batch operation across every exported sound effect with no post-check, which caps workflow clarity at 3. Not a 2 because the sequence is fully defined with no gaps.

3 / 5

Progressive Disclosure

Sections are well organized (Prerequisites, Steps, Naming conventions, Version), no bundle files exist, and body references point to real repo files (`generate.ts`, `whip.mdx`, `packages/docs/sidebars.ts`) rather than to missing bundled files. Not a 5: the file is ~95 lines (over the under-50-line simple-skill case) and step 3's nine-item checklist is dense inline content that a full example page reference would offload better.

4 / 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 short, concrete, and correctly scoped to a specific package, but it states only the bare "what" with a single action. It lacks any "Use when..." trigger guidance and offers few natural trigger keywords, which caps both completeness and trigger-term quality at the midpoint.

Suggestions

Add an explicit trigger clause, e.g. "Use when adding a new sound effect, audio asset, or .wav file to @remotion/sfx or when asked to register new SFX in Remotion docs."

Broaden trigger coverage with natural synonyms users would actually say: "sound effect", "SFX", "audio", ".wav".

Hint at the full scope of the task (export the constant, create the doc page, register in sidebar, regenerate waveforms) so the description reflects the multi-step procedure.

DimensionReasoningScore

Specificity

The full description is "Add a new sound effect to @remotion/sfx" — it names a concrete single action ("Add") and a specific target package, matching the anchor "Names domain and 1-2 concrete actions, but not comprehensive". It is not a 4 because only one action is stated; the actual procedure (export, doc page, registration, build) is not hinted at.

3 / 5

Completeness

The "what" is clear ("Add a new sound effect to @remotion/sfx"), but the "when" is entirely absent — no "Use when..." or equivalent trigger guidance, which per the judging guidelines caps completeness at 3. Not a 4 because there is not even a weakly implied "when" clause.

3 / 5

Trigger Term Quality

"sound effect" and "sfx" (via "@remotion/sfx") are natural terms a user would say, but coverage stops there — no "audio", ".wav", or other common variations, matching "Some relevant keywords but missing common variations or synonyms". Not a 4 because two terms is thin coverage rather than "a few natural terms missing" from a broad set.

3 / 5

Distinctiveness Conflict Risk

The scoped package name "@remotion/sfx" makes this a clear niche unlikely to trigger for unrelated skills — "Mostly distinct; minor overlap risk". Not a 5 because "sound effect" alone is a fairly generic term and the description carries no explicit trigger phrases that would separate it from a broader audio/media skill.

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: 1 missing

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.