CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

general-video

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

73%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-engineered operational skill: the workflow is clearly sequenced with real validation gates and a completion checklist, and commands are specific and executable. Weaknesses are rhetorical padding in the companion-flow and dispatch sections, oversized inline paragraphs, and a missing referenced bundle file (`sub-agents/frame-worker.md`) that breaks the dispatch role-assembly step as bundled.

Suggestions

Add the missing `sub-agents/frame-worker.md` (referenced by both the section 5 dispatch step and scripts/frame-packets.mjs) or remove the reference, since the worker-role assembly currently fails as bundled.

Move the section 5 step 1 plan-stage policy (catalog search rules, storyboard block format, citation rules) into a reference file and keep a short summary inline.

Trim the companion-flow rhetoric ("Arrive as the director, not the contractor", "The ceiling belongs to the concept, not the toolbox") to directive statements — the principles are useful but stated at essay length.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence (no explaining of what video editing or HTML is), but several sections are noticeably padded: the companion-flow prose ("A user who chose companion chose involvement and quality; the honest response is the best version you can design, not the smallest one you can defend", "The ceiling belongs to the concept, not the toolbox") is motivational rhetoric rather than instruction, and step 1 of section 5 is a single enormous paragraph inlining catalog-search policy, storyboard blocks, and citation rules that belong in a reference. This fits "mostly efficient but includes some unnecessary explanation or could be tightened" rather than the 4 anchor's "minor instances".

3 / 5

Actionability

Commands are concrete and mostly copy-paste ready with defined placeholders: `npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video`, `node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard ...`, `npx hyperframes check`, plus exact data attributes (`data-media-start`, `data-duration`, `data-has-audio="true"`). It stops short of the 5 anchor because several operational paths are outside this bundle and unverifiable, and the dispatch workflow's `sub-agents/frame-worker.md` — cited as "this skill's" file — is absent, so the pipeline as bundled is not fully executable.

4 / 5

Workflow Clarity

The process is explicitly sequenced with validation checkpoints and feedback loops: the section 2 state table routes entry, section 5 gives a numbered 8-stage dependency order, lint is positioned as fast feedback with check as the final gate ("it reruns lint internally, so do not run a redundant standalone lint"), failures are surfaced ("Surface an update failure instead of continuing from memory"), and section 7 is a completion checklist with a kept approval question before render. This matches the top anchor with explicit validation, error-recovery handling, and a checklist.

5 / 5

Progressive Disclosure

The body acts as a routing overview with clearly signaled, one-level-deep references, mostly via condition→read tables ("Any composition HTML or scene layout → /hyperframes-core"), and its own script bundle exists with tests. It does not reach 5 because one intra-bundle reference is broken (`sub-agents/frame-worker.md` is cited in both the body and scripts/frame-packets.mjs's `deltaPath` but does not exist in this bundle) and long policy runs like the step-1 plan paragraph are inlined rather than split into a reference.

4 / 5

Total

16

/

20

Passed

Description

87%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: it states what and when with concrete trigger phrases, uses natural production vocabulary, and explicitly fences off the two adjacent skills. The only residual weakness is that the capability list is carried by artifact-type nouns rather than distinct action verbs, and generic terms like "video" are absent.

Suggestions

Add one or two plain-language synonyms (e.g., "longer videos", "edit or remix existing footage") so users who don't know HyperFrames terminology still trigger the skill.

Consider naming one more concrete action beyond "Author or edit" (e.g., assemble multi-scene pieces, build title cards and loops) to strengthen the capability list.

DimensionReasoningScore

Specificity

The description opens with the concrete actions "Author or edit a custom HyperFrames composition" and enumerates specific deliverable types ("brand and sizzle reels, montages, static loops, static title cards, footage remixes"), matching the anchor listing several specific items with minor coverage gaps. It does not reach a 5 because the action set is really one verb pair (author/edit) plus artifact categories, not multiple distinct concrete operations like the 5-anchor example.

4 / 5

Completeness

It explicitly answers both questions: the what is "Author or edit a custom HyperFrames composition" and the when is given twice with concrete triggers — "when no specialized workflow fits, or when BRIEF.md sets flow: companion" and "Use for longer or multi-scene pieces, brand and sizzle reels...". It even adds routing preconditions ("Route fresh creation through hyperframes before using this skill"), so it clearly fits the top anchor rather than the 4-anchor's "when could be more explicit".

5 / 5

Trigger Term Quality

It includes natural production vocabulary users would actually say — "sizzle reels", "montages", "title cards", "footage remixes", "multi-scene pieces" — giving good keyword coverage. It stays at 4 rather than 5 because common phrasings like "video", "edit video", or "make a video" are never stated, and terms like "static loops" and "freeform builds" lean toward this ecosystem's own jargon.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (the fallback/general composition workflow) and actively disambiguates against the nearest neighbors: "Use motion-graphics instead for a short unnarrated motion-first unit" and "Route fresh creation through hyperframes before using this skill". These explicit negative boundaries give minimal conflict risk, matching the 5 anchor.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 16 missing

Warning

Total

14

/

16

Passed

Repository

heygen-com/hyperframes

Path

skills/general-video/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.