CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ai-video-gen

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

56

Quality

71%

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/ai-video-gen/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

38%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 body reads as a monolithic HeyGen REST API reference with heavy duplication across three languages and five near-identical examples, while the multi-gateway orchestration it advertises is under-specified: the mandated video_selector tool is undocumented, 'Layer 3' reference files do not exist in the bundle, and default-provider guidance is self-contradictory. The one fully worked path (HeyGen submit/poll/retrieve) is genuinely executable and well-structured.

Suggestions

Move the full HeyGen REST reference (request fields, provider table, response formats, code samples) into a references/ file (e.g. references/heygen-api.md) and keep only a short submit-poll-retrieve sequence in SKILL.md, removing the curl/TypeScript/Python triplication and the three redundant Usage Examples.

Either document video_selector concretely (parameters, how it reports availability/cost/fallback, example call) or drop the 'Always use video_selector instead of calling provider tools directly' mandate, since nothing in the skill or bundle shows how to invoke it.

Create the referenced Layer 3 files (gemini-omni, seedance-2-0) or remove the pointers, and reconcile the contradictory default-provider guidance ('Do not describe any gateway as the default' vs 'Preferred premium default — Seedance 2.0' vs 'veo_3_1 (default, highest quality)').

DimensionReasoningScore

Conciseness

The same HeyGen POST /v1/workflows/executions call is demonstrated at least five times (Overview curl, Execute curl, Usage Examples x3) and in three languages (curl, TypeScript, Python), and ~200 lines of REST API reference are inlined that an agent with mcp__heygen__* tools never needs. Marketing prose like 'ranks #1 on Artificial Analysis Elo as of early 2026' and 'the only model in the fleet with single-pass native synchronized audio, multi-shot generation, director-level camera control, and lip-sync from quoted dialogue' pads further. This matches 'noticeably verbose; several unnecessary explanations or padded sections' rather than anchor 3's 'some unnecessary explanation'.

2 / 5

Actionability

The HeyGen path is fully executable (complete curl/TypeScript/Python with polling, error handling for failed/not_found, and timeout), but the mandated entry point is not actionable at all: 'Always use video_selector instead of calling provider tools directly' is stated with zero documentation of video_selector's inputs or outputs, and 'See Layer 3 gemini-omni / seedance-2-0 for the authoritative prompting guide' points to files that do not exist in the bundle. Key details for the primary instruction are missing, which fits anchor 3 ('concrete guidance but incomplete') better than anchor 4's 'minor gaps'.

3 / 5

Workflow Clarity

The HeyGen sequence is clear (submit → execution_id → poll every 10s → video_url, with failed/not_found handling), but the skill's core multi-gateway decision flow is contradictory and unresolved: 'Do not describe any gateway as the default or top choice without checking the registry' (registry never defined) versus 'Preferred premium default — Seedance 2.0' versus the provider table's 'veo_3_1 (default, highest quality)', and the Default Workflow never integrates the mandated video_selector step. Sequence present but the actual decision checkpoints are missing or implicit, matching anchor 3; it does not reach anchor 4's coherent mostly-checkpointed flow.

3 / 5

Progressive Disclosure

No references/, scripts/, or assets/ directories exist, yet the body twice directs the agent to 'Layer 3' guides (gemini-omni, seedance-2-0) for authoritative material — broken navigation. Meanwhile ~200 lines of HeyGen API reference that clearly belong in a separate file are inlined in SKILL.md. This matches anchor 2 ('content that clearly belongs in separate files is inlined; or references are buried/broken') despite the presence of section headers, because the only file-level references in the skill point to nonexistent files.

2 / 5

Total

10

/

20

Passed

Description

95%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: third-person voice, explicit 'Use when' triggers, concrete actions, and comprehensive provider/gateway keywords. The only weaknesses are slight redundancy between trigger items (1) and (2) and omission of the iterative-editing capability the body promotes.

DimensionReasoningScore

Specificity

Concrete actions are named: 'Generate AI videos from text prompts', 'Image-to-video generation with a reference image', and 'Choosing between video generation providers', with seven specific provider names. It falls short of anchor 5 because items (1) and (2) largely duplicate each other and a capability the body emphasizes heavily — iterative/conversational editing of existing clips via Gemini Omni — is omitted from the action coverage.

4 / 5

Completeness

Explicitly answers both questions: 'what' via 'Generate AI videos from text prompts using multiple provider gateways' and 'when' via an enumerated 'Use when: (1)...(2)...(3)...(4)' clause with concrete trigger phrases, matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage: 'AI videos', 'video clips', 'text prompts', 'image-to-video', 'video generation', plus seven provider names (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni) users would naturally say when needing this skill. Not below anchor 4 — no meaningful natural synonym or trigger phrasing is missing for this domain.

5 / 5

Distinctiveness Conflict Risk

Clear niche (AI video generation) with distinct triggers including seven named providers and four named gateways, making it unlikely to fire for unrelated skills. Minor risk only from overlapping with a hypothetical single-provider video skill, which the explicit gateway list already disambiguates.

5 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

13

/

16

Passed

Repository

calesthio/OpenMontage

Path

.agents/skills/ai-video-gen/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.