CtrlK
BlogDocsLog inGet started
Tessl Logo

captions-overlay

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint

64

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/captions-overlay/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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-structured, actionable doctrine document with concrete numeric guidance and clean sectioning. Its main weakness is repetition across the intro, model, and synthesis sections, and the absence of any sequenced workflow or validation loop — acceptable here given its doctrinal nature but reflected in the workflow score.

Suggestions

Collapse the closing 'Why these two rules are one doctrine' section into a short bullet list or fold it into the intro, since it restates the rail/embed and overlay-not-band points already made above.

Consolidate the rail-first/embed-scarce rules so they appear once (either in the table section or the quoted non-negotiables) rather than being partially repeated across the intro, table, and quoted list.

If a typical captioning pass has a recommended order (e.g., classify each phrase → place rail → promote at most one embed → visually QA caption-over-content legibility), surface it as a short numbered checklist with the existing 'judge legibility visually' step as the validation checkpoint.

DimensionReasoningScore

Conciseness

Mostly efficient and free of generic-concept padding, but the opening 'Two ideas combine here' paragraph, the model section, and the closing 'Why these two rules are one doctrine' section restate the same rail/embed and overlay-not-band principles, so it could be tightened.

3 / 5

Actionability

Gives concrete, actionable specifics — '≤1 embed per beat', 'never two adjacent or co-visible', '≥ a beat apart', 'y = H / 2 (landscape 540, portrait 960)', 'bottom ~5-8% of canvas height', '~80px center span' — leaving only minor abstraction in the doctrinal framing.

4 / 5

Workflow Clarity

The decision rules (drop/rail/embed, captions enabled vs disabled, Standard vs Cinematic) are clearly organized, but there is no sequenced multi-step workflow or validation checkpoint because the skill is a doctrine rather than a procedure.

3 / 5

Progressive Disclosure

Well-organized into clearly headed sections (caption model, overlay law, synthesis) with no nested references; the only external mentions (embedded-captions, product-launch-video scene agent) are upstream skills appropriately signaled rather than bundle files.

4 / 5

Total

14

/

20

Passed

Description

88%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, highly specific description that clearly states both capability and trigger conditions, with concrete natural-language triggers and explicit disambiguation from its sibling skill. Minor keyword-variation gaps keep it just short of perfect on trigger coverage and distinctiveness.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'adding captions/subtitles', 'deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax', 'laying out a composition that will carry captions (do NOT reserve a keep-out band)', 'centering a composition on the true frame center' — giving comprehensive coverage of the doctrine.

5 / 5

Completeness

Explicitly answers both what (the caption drop/rail/embed model and the overlay-not-band law) and when via a concrete 'Load when...' clause enumerating several trigger scenarios.

5 / 5

Trigger Term Quality

Includes natural user terms 'captions', 'subtitles', 'talking-head', 'launch video' with the synonym pair captions/subtitles, but misses a few common variations such as 'closed captions' or 'lower thirds'.

4 / 5

Distinctiveness Conflict Risk

Has a clear niche (overlay compositing doctrine, keep-out band retired) and explicitly disambiguates from the upstream embedded-captions skill ('Applies ON TOP of embedded-captions'), with only minor overlap risk against that closely related skill.

4 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.