Content
38%Weight 40%Scale 1-5Reviews 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)').
| Dimension | Reasoning | Score |
|---|---|---|
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 |