add-expert

Add a new expert to the Remotion experts page

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/add-expert/SKILL.md

Quality

Content

100%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 an exemplar of a concise, fully-actionable single-task skill: complete copy-paste template, exact paths and commands, and an explicit verification checkpoint. No changes are needed.

Dimension	Reasoning	Score
Conciseness	The body is lean and entirely actionable: concrete paths, a complete copy-paste TSX template, and an exact command with no concept explanations Claude wouldn't already know, matching the 'every token earns its place' anchor.	5 / 5
Actionability	Guidance is fully executable — exact file paths, a complete TSX entry with all fields and types, the `bun render-cards` command, and the precise generated filename plus verification string — meeting the 'copy-paste ready, covers common cases' anchor.	5 / 5
Workflow Clarity	Three clearly sequenced steps with an explicit validation checkpoint in step 3 (verify "Rendered experts-<slug>" not "Existed"); as an additive single-purpose task it qualifies for the simple-skill top score and is not subject to the destructive/batch cap.	5 / 5
Progressive Disclosure	A self-contained skill under 50 lines with no external bundle files, organized under a clear `## Steps` heading with three numbered steps, satisfying the simple-skill exception for top progressive-disclosure scoring.	5 / 5
	Total	20 / 20 Passed

Description

51%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 clear and distinct but minimal: it states one concrete action on a specific page and omits any 'when to use' trigger guidance, capping completeness. Adding a 'Use when…' clause and a few synonyms (e.g. 'freelancer') would meaningfully improve it.

Suggestions

Add an explicit trigger clause such as 'Use when adding a new expert or freelancer to the Remotion experts page.'

Include natural synonyms users might say (e.g. 'freelancer', 'consultant') to broaden trigger-term coverage.

Optionally hint at the scope of the action (photo, data entry, card rendering) so the 'what' reads as more than one minimal step.

Dimension	Reasoning	Score
Specificity	Names the concrete domain ("Remotion experts page") and one concrete action ("Add a new expert"), but offers only a single action with no breadth of capability, placing it between the single-action anchor 3 and the minimal-action anchor 2.	2.5 / 5
Completeness	The 'what' is clear ("Add a new expert to the Remotion experts page") but there is no 'Use when…' trigger clause, so per the missing-trigger-guidance cap it cannot exceed 3.	3 / 5
Trigger Term Quality	"expert" is a natural user keyword tied to a recognizable object ("experts page"), but no synonyms or variations (e.g. "freelancer") are present, matching the 'some relevant keywords but missing variations' anchor.	3 / 5
Distinctiveness Conflict Risk	"Remotion experts page" is a distinct niche with low overlap risk, but the trigger vocabulary is not rich enough to reach the comprehensive-anchor 5.	4 / 5
	Total	12.5 / 20 Passed

Validation

100%

Warnings & errors only

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
Path: .agents/skills/add-expert/SKILL.md
Commit: dbb2c0a

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.