CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fal-ai-media

Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/fal-ai-media/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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.

A well-organized, largely actionable reference with concrete examples and parameter tables for every workflow. Its weaknesses are the absence of validation/polling checkpoints for async generation and cost control (buried in Tips rather than sequenced steps), and a monolithic single-file layout where model reference material and alternative integrations should be split into referenced files.

Suggestions

Add an explicit async workflow with checkpoints: submit generate → poll result/status → retry or adjust prompt on failure, and make estimate_cost a numbered pre-step for expensive video models instead of a tip.

Move the per-model parameter reference and the ElevenLabs/VideoDB alternative integrations into references/ files (e.g. models.md, alternatives.md) linked from SKILL.md to slim the main file.

Delete the redundant 'When to Activate' bullets that restate the description, especially the vague 'Any media generation task'.

DimensionReasoningScore

Conciseness

The body is dense and mostly earns its tokens: compact parameter tables, one example per model, and 'Best for' lines that aid model selection. Minor trimmable padding remains — the 'When to Activate' section restates the description with vague bullets like 'Any media generation task', and the MCP tool list could be tightened. Not 3 because there is no concept-explaining filler and every section carries operational content.

4 / 5

Actionability

Each workflow has a concrete example with real model names, parameter values ('image_size: landscape_16_9', 'duration: 5s'), and options tables; the image-editing flow shows the upload-then-generate sequence. Below 5 because the tool-call snippets are pseudocode-style rather than literal invocations, and 'estimate_cost(model_name: ..., input: {...})' leaves the input as an ellipsis placeholder.

4 / 5

Workflow Clarity

Sequences exist (upload source image, then generate with image_url; iterate on Nano Banana 2, switch to Pro for finals) but validation checkpoints are missing or implicit. The tool list exposes async 'result'/'status' tools, yet no workflow shows submit → poll → handle failure, and 'check estimate_cost before expensive video generations' is buried in Tips rather than being an explicit numbered step. This matches the 3 anchor: sequence present, checkpoints missing.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so all content lives in a ~270-line SKILL.md. Section structure is clear and well-organized, but content that would fit better in separate files — per-model parameter reference for seven models, and the ElevenLabs/VideoDB alternative integrations — is inlined, matching the 3 anchor of 'content that should be separate is inline' with good structure. Not 2 because the body is well-sectioned, not a headerless API dump.

3 / 5

Total

14

/

20

Passed

Description

80%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.

A strong description with clear what-and-when structure, specific model names, and a well-defined fal.ai MCP niche. Its main weakness is a generic single 'when' clause that omits the concrete trigger phrases and synonyms (thumbnail, music, voice, text-to-video) that the body already identifies.

Suggestions

Expand the 'when' clause with concrete trigger phrases, e.g. 'Use when the user says "generate an image", "make a video", "text to speech", or "create a thumbnail"'.

Add natural synonyms such as music, voice, narration, and sound effects to the trigger terms.

Name the fal.ai dependency more prominently at the start of the 'when' clause to reduce overlap with non-fal.ai media skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with named models: 'text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound)' — comprehensive coverage of the skill's capabilities. Not 4 because coverage spans all four media modalities the skill supports with no meaningful gap.

5 / 5

Completeness

Both parts are present: a clear 'what' ('Unified media generation via fal.ai MCP — image, video, and audio...') and an explicit 'when' ('Use when the user wants to generate images, videos, or audio with AI'). The 'when' clause is a single generic condition rather than concrete trigger phrases like 'when the user says X or mentions Y', which keeps it below the 5 anchor.

4 / 5

Trigger Term Quality

Good natural keyword coverage: 'generate images, videos, or audio with AI' plus 'text-to-speech'. Missing common variations users would say, such as 'make a thumbnail', 'text to video', 'voice', 'music', or 'sound effects' — the body even lists these phrases but the description omits them, so it does not reach the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The 'via fal.ai MCP' qualifier establishes a clear niche with distinct triggers around fal.ai models. Minor overlap risk remains with closely related media skills (the body itself lists videodb, video-editing, content-engine) since generic requests like 'generate an image' could match other image-generation skills. Not 5 because the broad 'generate images, videos, or audio' trigger has no differentiator for overlapping skills.

4 / 5

Total

17

/

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

ysyecust/everything-claude-code

Path

.agents/skills/fal-ai-media/SKILL.md

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.