CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

71

Quality

89%

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

88%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 dense, highly operational workflow document: exact commands at every stage, a well-sequenced pipeline with real validation gates, and disciplined reference routing. The main costs are rhetorical flourish in the companion section and some inlined dispatch detail that belongs in a bundled reference.

Suggestions

Trim the companion-flow rhetoric (e.g., the 'director, not the contractor' and 'ceiling belongs to the concept' passages) to their operative directives to save tokens without losing guidance.

Move the §5 dispatch mechanics (packet contents, worker role assembly, wave rules) into a bundled reference and link it, keeping the stage list lean.

Resolve the dangling `sub-agents/frame-worker.md` reference — either ship the file in the bundle or point to an existing path.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence throughout — no basic-concept explanations — and nearly every sentence carries a directive or a concrete fact (e.g., "measured: 5 short scenes ≈ 9 min inline vs ≈ 21 min packetized"). It is 4 not 5 because rhetorical framing in the companion section ("Arrive as the director, not the contractor.", "The ceiling belongs to the concept, not the toolbox.") and the very long §5 plan paragraph could be tightened without losing instruction.

4 / 5

Actionability

Copy-paste-ready commands with exact flags cover every stage: `npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video`, `node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>`, `node <SKILL_DIR>/scripts/frame-packets.mjs --project ... --storyboard ...`, `npx hyperframes catalog --query "<the look, in plain English>" --json`, `npx hyperframes lint` / `check`. Placeholders are defined inline ("Here `<MEDIA_DIR>` is the installed `/media-use` skill directory..."). Full executability with common cases covered matches the 5 anchor.

5 / 5

Workflow Clarity

A clear state table routes entry (specific edit / brief exists / resume / fresh), then an explicitly ordered dependency chain (plan → review → resolve → build → merge → assemble → verify → final approval) with validation checkpoints and feedback loops: lint after the first HTML pass, `npx hyperframes check` as the final gate, and a §7 done-checklist requiring checks to pass and the rendered file to be verified. Explicit validation plus error-recovery gating matches the 5 anchor.

5 / 5

Progressive Disclosure

Structure is good: the body is an overview routing to clearly signaled, one-level-deep references (`../hyperframes/references/brief-contract.md`, `/hyperframes-creative` → `references/house-style.md`), and the referenced `scripts/frame-packets.mjs` exists in the bundle. It is not 5 because the §5 dispatch detail (packet contents, worker role assembly) is inlined rather than placed in a reference, and the referenced `sub-agents/frame-worker.md` is not present in the actual bundle, leaving a dangling path.

4 / 5

Total

18

/

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 answers both what and when explicitly, enumerates concrete use-case triggers, and — unusually well — actively routes away from neighboring skills to prevent mis-triggering. Slight headroom remains in broadening natural trigger synonyms and action verbs.

DimensionReasoningScore

Specificity

"Author or edit a custom HyperFrames composition" names two concrete actions, and the enumerated artifact list ("brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds") gives specific coverage. It stays at 4 rather than 5 because the action verbs are limited to author/edit — it does not name further concrete operations (render, verify, assemble) the way the 5-anchor example lists four distinct actions.

4 / 5

Completeness

The what is explicit ("Author or edit a custom HyperFrames composition") and the when is explicit with concrete triggers ("when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces..."). Both are stated with trigger phrases, matching the 5-anchor; it cannot be lower since both halves are present and specific.

5 / 5

Trigger Term Quality

Natural production vocabulary is present — "sizzle reels", "montages", "static loops", "static title cards", "footage remixes", "multi-scene" — terms a user planning a video would plausibly say. It is not 5 because some common user phrasings (e.g., "promo video", "make me a video", "highlight reel") are absent, and the odd "freeform builds" is more internal jargon than a natural trigger.

4 / 5

Distinctiveness Conflict Risk

It actively disambiguates against sibling skills: "Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title" and "Route fresh creation through hyperframes before using this skill." This is a clear niche with explicit conflict-avoidance guidance, exceeding the 4-anchor's 'minor overlap risk'.

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