CtrlK
BlogDocsLog inGet started
Tessl Logo

add-expert

Add a new expert to the Remotion experts page

60

Quality

70%

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

Quality

Content

86%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, well-sequenced, fully actionable procedure with a built-in verification step and zero padding — a model example of a small, single-purpose skill. The only real gaps are the placeholder-laden entry template (mitigated by the follow-up bullet rules) and the absence of recovery guidance if the render verification fails.

DimensionReasoningScore

Conciseness

The body is lean and entirely instructional: three numbered steps, exact file paths, a single data-entry template, and one render command, with no explanation of concepts Claude already knows and no padding. Every token earns its place, matching the top anchor.

5 / 5

Actionability

Guidance is highly concrete — exact paths ("packages/docs/static/img/freelancers/<firstname>.png"), a full entry template with all fields, and the exact command "bun render-cards" — but the tsx template uses placeholders and illustrative union notation ("'https://example.com' | null", "YYYY-MM-DD") that must be interpreted rather than executed literally. This fits anchor 4 (mostly executable, minor gaps), not anchor 5 (fully copy-paste ready).

4 / 5

Workflow Clarity

The three steps are clearly sequenced and include an explicit verification checkpoint ("Verify it says 'Rendered experts-<slug>' (not 'Existed')"), which goes beyond a bare step list. It stops short of anchor 5 because there is no feedback loop telling Claude what to do if verification fails (e.g. if the card already exists), leaving a minor validation gap.

4 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and needs no external reference files; the numbered-step structure is well organized with each step's details (paths, template, verification) placed inline appropriately. Per the rubric's simple-skill guideline, this merits the top score; there are no buried or nested references.

5 / 5

Total

18

/

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 clearly niche-scoped, but it omits any trigger guidance for when to use the skill and lacks natural keyword variations (notably "freelancer", the term the body actually uses). It communicates the "what" effectively but not the "when".

Suggestions

Add a "Use when..." clause naming natural trigger phrases, e.g. "Use when adding a freelancer or expert to the Remotion experts page or when asked to update the experts showcase list."

Include synonym keywords users would actually say, such as "freelancer" (the image directory is named freelancers), "experts list", and "experts page", to improve trigger term coverage.

Briefly enumerate the concrete actions involved (add photo, add data entry, render card) so the description conveys the skill's scope, not just its subject.

DimensionReasoningScore

Specificity

Names one concrete action ("Add a new expert") with a specific target ("the Remotion experts page"), but describes no further actions, matching the anchor for 1-2 concrete actions without comprehensive coverage. It is above anchor 2 because the action is concrete rather than generic, and below anchor 4 because there is no list of several specific capabilities.

3 / 5

Completeness

The "what" is clear (add a new expert to the Remotion experts page) but there is no "when" or "Use when..." clause or equivalent trigger guidance anywhere, which the judging guidelines explicitly cap at 3. It is not anchor 2 because the "what" is specific rather than vague.

3 / 5

Trigger Term Quality

"expert", "Remotion", and "experts page" are relevant keywords a user might say, but common variations and synonyms are missing — e.g. "freelancer" (the actual directory name used in the body), "add to experts list", or "showcase". This fits the 'some relevant keywords but missing common variations' anchor, not the comprehensive anchor 5.

3 / 5

Distinctiveness Conflict Risk

"Remotion experts page" carves out a clear niche, so it is mostly distinct with only minor overlap risk against other Remotion or page-editing skills (anchor 4). It falls short of anchor 5 because the description gives no distinguishing trigger phrases to further reduce overlap.

4 / 5

Total

13

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.