create-video

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Quality

86%

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

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is actionable and well-structured with a clean progressive-disclosure layout pointing to real reference files. Its weaknesses are mild internal redundancy (repeated links and overlapping tables) and the absence of explicit error/polling feedback loops in the async generation workflow.

Suggestions

Add an explicit polling/error-handling checkpoint to the workflow — e.g., expected status values, poll interval, and what to do when a video fails — so async generation has a clear feedback loop.

De-duplicate the prompt-optimizer→visual-styles link (currently repeated four times) and consolidate the overlapping 'Tool Selection' and 'Quick Reference' tables into one to tighten token usage.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with curl examples, tool-selection tables, and numbered workflows, but the prompt-optimizer→visual-styles link is repeated four times and the 'Tool Selection' and 'Quick Reference' tables overlap; could be tightened. Not level 3 because of this redundancy, not level 1 because there is no concept-padding fluff.	2 / 3
Actionability	Provides an executable curl example, specific MCP tool names, concrete API endpoints (POST /v1/video_agent/generate, GET /v2/videos/{video_id}), and exact config params (duration_sec, orientation, avatar_id) — copy-paste ready.	3 / 3
Workflow Clarity	Two clearly sequenced numbered workflows (with/without MCP) and a poll-status step, but the async generate-then-poll operation has no explicit error/validation checkpoint (failed status handling, poll cadence, retry). Per rubric guidance for risky/batch-style async operations, missing feedback loops caps this at 2 rather than 3.	2 / 3
Progressive Disclosure	SKILL.md is a concise overview with well-organized sections; references are one level deep, descriptively labeled, grouped into 'Core Workflow' and 'Foundation', and all nine referenced files exist in references/. Easy navigation matches the clear-overview anchor.	3 / 3
	Total	10 / 12 Passed

Description

100%

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 specific, uses natural trigger phrasing, explicitly answers both what and when, and clearly distinguishes itself from the avatar-video skill. No first/second-person voice is used, so no penalty applies.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Create videos from a text prompt', 'Generating explainer, demo, or marketing videos', 'Quick video prototyping or drafts', 'One-shot prompt-to-video generation' — matching the multiple-specific-actions anchor.	3 / 3
Completeness	Clearly answers both what ('Create videos from a text prompt using HeyGen's Video Agent') and when via an explicit 'Use when: (1)...(6)' clause, satisfying the explicit-trigger anchor; not capped at 2 since 'Use when' guidance is present.	3 / 3
Trigger Term Quality	Natural phrasing a user would say is explicit — 'make me a video', 'create a video about X', plus explainer/demo/marketing and prototyping variants; not the level-2 single-keyword case because common variations are well covered.	3 / 3
Distinctiveness Conflict Risk	Clear niche (HeyGen prompt-to-video) with trigger (3) 'without specifying exact avatars, voices, or scenes' explicitly disambiguating from the avatar-video skill, so conflict risk is low.	3 / 3
	Total	12 / 12 Passed

Validation

75%

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 — 12 / 16 Passed

Validation for skill structure

Criteria	Description	Result
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
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	12 / 16 Passed

Repository: calesthio/OpenMontage
Path: .agents/skills/create-video/SKILL.md
Commit: 0af32ce

Reviewed: 1 day 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.