CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

music-to-video

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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.

An exemplary orchestrator skill body: every step is executable, gated, and validated with feedback loops, and detail is properly deferred to one-level-deep references with a read-when table. The two deductions are a broken reference (`sub-agents/frame-worker.md` is missing from the bundle) and modest redundancy in restating the bpm-trust caveat.

Suggestions

Add the missing `sub-agents/frame-worker.md` to the bundle — it is cited in Step 4, the Quick Reference, and the Directory layout but is absent.

State the bpm/beats_sec trust caveat once (in 'Two ideas') and reference it from Steps 1–2 instead of restating it three times.

Tighten Step 0's auth-status paragraph by deferring the sign-in/offline decision detail to the `/hyperframes-media` reference it already cites.

DimensionReasoningScore

Conciseness

The body is dense and purpose-built: every step carries commands, gates, or constraints, and it never explains concepts Claude already knows. Minor trimmable redundancy keeps it off anchor 5 — the bpm/beats_sec trust caveat is restated in 'Two ideas that shape everything', again in Step 1, and again via Step 2's pacing, and Step 0's auth-status paragraph is a long digression. Not anchor 3: there is no padding or gratuitous explanation, only deliberate (if repeated) reinforcement.

4 / 5

Actionability

Fully executable throughout: copy-paste-ready commands for every step (`npx hyperframes init ... --non-interactive --example=blank`, the `pip install librosa numpy soundfile` fallback, `python3 <SKILL_DIR>/scripts/analyze-beatgrid.py ... -o ... --print`, `validate-plan.mjs`, `assemble-index.mjs`, the lint/validate/inspect chain, and the final `render ... -o renders/video.mp4 --fps 30`), plus a fully specified sub-agent dispatch context template with concrete placeholder semantics. This matches anchor 5's copy-paste-ready coverage of the common cases.

5 / 5

Workflow Clarity

Steps 0–6 are clearly sequenced with an explicit **Gate** checkpoint after each, user-approval gates at Steps 3 and 6, and machine validation with error-recovery feedback loops: 'Fix every `✗` (hard errors...)', 'a missing or blank frame file means that worker wrote a partial file; re-dispatch it (Step 4) and re-assemble', and install-on-import-failure at Step 1. The batch operation (one sub-agent per frame) is validated at Steps 4–6, and a Resume table handles mid-pipeline restarts — a full match to anchor 5.

5 / 5

Progressive Disclosure

Good structure overall: the body is an orchestrating overview, detailed material is split one level deep into `references/` and read exactly when needed ('Read [`references/frame-skeleton.md`](references/frame-skeleton.md)' at Step 2; the planning/template/montage references at Step 3), and a Quick Reference table maps each read to its step. It falls short of anchor 5 because `sub-agents/frame-worker.md` — referenced in Step 4, the Quick Reference, and the Directory layout — does not exist in the bundle, a broken in-bundle reference, and several cross-skill paths (`../hyperframes-core/...`, `../hyperframes-creative/...`) are unverifiable here. Not anchor 3: references are clearly signaled, one level deep, and the split is otherwise appropriate.

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: explicit 'Use when...' trigger with concrete input conditions, a concrete multi-stage capability list, and a clearly bounded niche. The only weaknesses are coverage gaps (no mention of rendering/MP4 output) and a few missing natural synonyms like 'song' or '.mp3'.

Suggestions

Add the output artifact (e.g. 'renders an MP4') to close the capability-coverage gap in the action list.

Include one or two common synonyms/extensions ('song', 'music video', '.mp3') among the trigger terms.

DimensionReasoningScore

Specificity

The description lists several concrete pipeline actions — "one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame" and user media "cut into the frames on the same beat grid (beat-cut / ken-burns)" — which is well past the 1–2 actions of anchor 3. It stops short of anchor 5's comprehensive coverage because the downstream capabilities (assembly, verification, rendering to an MP4) are never mentioned, so the action list has minor gaps.

4 / 5

Completeness

It explicitly answers both questions with concrete trigger phrases: "Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video" (when) and the pipeline description of what the skill does with that track (what). This matches anchor 5; anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "music track", "audio file", "video to pull audio from", "beat-synced", "lyric video, slideshow, kinetic promo", and "images or videos" — phrases a user would plausibly say. Missing common synonyms and extensions ("song", "music video" itself, ".mp3"), so it does not reach anchor 5's comprehensive synonym/extension coverage, but it is well above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is clear and the triggers are distinct: triggering is tied to possessing a music track and wanting a beat-synced video, with explicit boundary notes ("a complete video needs zero assets"; "the pipeline never branches on it" for genre). Minimal conflict risk with non-music video skills; not anchor 4, since the trigger conditions are sharply discriminating rather than merely 'mostly distinct'.

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: 2 missing

Warning

referenced_paths_exist

Referenced path issues: 6 missing

Warning

Total

14

/

16

Passed

Repository

calesthio/OpenMontage

Path

.agents/skills/music-to-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.