CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

motion-graphics

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

Quality

90%

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

85%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 orchestrator body: fully executable commands, explicit validation and repair loops, a resume table, and clean one-level-deep reference signaling. The two real weaknesses are token redundancy at the top (routing blockquote duplicating the description, maintainer notes inline) and a bundle that ships only the references/ third of the files the body points to, leaving the agents/, phases/, and categories/ detail paths unresolved.

Suggestions

Ship the referenced detail files in the bundle (agents/director.md, agents/builder.md, agents/finalize.md, phases/source/guide.md + resolve.mjs, categories/<id>/module.md, catalog-map.md) or inline their minimal content — most 'Detailed flow' pointers currently dead-end.

Drop the opening routing blockquote (it duplicates the frontmatter description nearly verbatim, which is loaded anyway) and move the maintainer 'Design notes' section to a separate non-execution file so the always-loaded SKILL.md carries only execution-relevant tokens.

Replace the Step 2 'illustrative' resolve command with the real invocation once phases/source/resolve.mjs is present, so every Bash step is copy-paste executable.

DimensionReasoningScore

Conciseness

The body is dense and operational throughout — phase tables, category tables, exact bash, and a maintainer section explicitly marked "execution does not read this" — with zero explanation of concepts Claude already knows. It falls short of anchor 5 ("every token earns its place") due to redundancy: the opening routing blockquote ("A longer, multi-scene, or narrated treatment → /general-video; a narrated video of a website → /website-to-video...") nearly duplicates the frontmatter description that loads alongside it, the phase table overlaps the Flow steps it summarizes, and the ~20-line maintainer "Design notes" section spends always-loaded tokens on non-execution content.

4 / 5

Actionability

Copy-paste-ready commands for every Bash phase — init ("npx hyperframes init \"$PROJECT_DIR\" --non-interactive --example=blank"), render ("npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4"), verify ("npx hyperframes lint . && npx hyperframes inspect ."), preview — plus a one-line validation ("[ -s \"$PROJECT_DIR/shot-plan.json\" ] && echo ok || echo missing"), an enforced subshell convention ("every Bash command... is a (cd \"$PROJECT_DIR\" && ...) subshell"), and exact subagent prompt composition. The single illustrative command in Step 2 is explicitly flagged ("# illustrative — see phases/source/guide.md"), which the guidelines accept as justified flexibility. Common cases (asset-free vs. sourced, mp4 vs. overlay) are each covered.

5 / 5

Workflow Clarity

Steps 0-6 are clearly sequenced with a conditional branch ("If asset_needs is empty, skip to Step 3"), explicit validation checkpoints at each handoff (the shot-plan existence check, lint/inspect with "exit 0 → done"), an error-recovery feedback loop ("On lint/inspect errors, dispatch the repair subagent... one in-place fix pass + re-render"), a graceful-degradation path for missing providers, and a resume table keyed on artifact state ("no shot-plan.json → Step 1", "renders/video.mp4 exists → Report + stop"). This matches anchor 5's feedback loops and checkpoints.

5 / 5

Progressive Disclosure

The body's structure and signaling are strong — the phase table's "Detailed flow" column, "See phases/source/guide.md", and per-category "categories/<id>/module.md" pointers are one level deep and clearly labeled, and the three files under references/ (motion-vocabulary.md, shot-plan-ir.md, builder-contract.md) do exist and match their citations. However, scored against the actual bundle: the majority of referenced detail files — agents/director.md, agents/builder.md, agents/finalize.md, phases/source/guide.md, phases/source/resolve.mjs, categories/<id>/module.md, and catalog-map.md — are absent from the provided bundle, so most navigation pointers dead-end. That is more than the "minor organization gaps" of anchor 4 but well above the inlining/buried-reference problems of anchor 2, leaving anchor 3 (structure present, organization incomplete).

3 / 5

Total

17

/

20

Passed

Description

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

An excellent frontmatter description: explicit "Use when" triggers with a comprehensive, natural-sounding vocabulary of deliverable types, clear duration/narration boundaries, and explicit negative routing to six sibling skills. The only weakness is that capability verbs are implicit — it enumerates what users ask for rather than stating what the skill does.

DimensionReasoningScore

Specificity

The description enumerates a comprehensive set of concrete deliverables — "kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster" — plus a concrete output capability ("Can render to MP4 or transparent overlay") and explicit duration boundaries. It falls short of anchor 5 because the action verbs are largely implicit: it never says it creates/animates these artifacts, instead relying on noun-phrase enumeration ("Use when the user wants a short, design-led motion graphic..."); anchor-5 examples state multiple explicit actions ("Extract text... fill forms, merge documents"). It is well above anchor 3, which expects only 1-2 concrete actions with limited coverage.

4 / 5

Completeness

Both halves are explicit with concrete trigger phrases: the "when" is "Use when the user wants a short, design-led motion graphic where motion is the message: [12 concrete trigger types]", and the "what" is the deliverable set plus "Can render to MP4 or transparent overlay". It also adds negative triggers ("Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video)...") that sharpen the when. This matches the anchor-5 example's structure (explicit what + explicit 'Use when' with concrete triggers); anchor 4 would require the when to be merely present but less specific, which is not the case.

5 / 5

Trigger Term Quality

Natural user phrasings are comprehensively covered with synonyms: "kinetic typography", "stat or number count-up", "logo sting", "lower-third", "social overlay", "animated headline/tweet/news item", "motion poster", "transparent overlay", "MP4". These are exactly the words a user asking for this kind of piece would say. It does not fit anchor 4 ("a few natural terms missing") because both the plain-language variants ("number count-up") and the designer vocabulary ("brand lockup", "logo sting") are present.

5 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (short, unnarrated, motion-first, "Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject") and explicitly disambiguates against six sibling skills by name — "(use general-video)", "(website-to-video)", "(faceless-explainer)", "(product-launch-video)", "(pr-to-video)", "(embedded-captions)" — plus a tie-breaker ("When unsure... see /hyperframes"). Minimal conflict risk with distinct triggers, matching anchor 5.

5 / 5

Total

19

/

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

metadata_version

'metadata.version' is missing

Warning

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

14

/

16

Passed

Repository

calesthio/OpenMontage

Path

.agents/skills/motion-graphics/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.