CtrlK
BlogDocsLog inGet started
Tessl Logo

chat-motion-overlay

Generate configurable chat motion overlays from a transcript or screenshot, including plain bubble scenes, app-style chat containers, optional device frames, preset or uploaded avatars, nickname display rules, and transparent-video-ready Remotion bundles. Use when Codex needs to create reusable short-form chat clips for Douyin, demo videos, story reenactments, social-message proof scenes, or embeddable alpha overlays for Hyperframe and Remotion workflows.

68

Quality

83%

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

75%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 skill body with a clear five-step workflow and verified one-level-deep references. Weaknesses are minor: duplicated content between body sections and reference files (avatar policy, question policy, format labels), inlined config enumerations, and the absence of an explicit validation/preview checkpoint before final render.

Suggestions

Collapse the 'Supported Dimensions' section into references/config-schema.md (or reduce it to a one-line pointer), since it duplicates the config reference and repeats the deliveryFormat labels already shown in step 5.

Drop the inline 'Question Policy' section in favor of the existing references/question-strategy.md reference to remove duplication.

Add a lightweight validation checkpoint between building the spec and rendering — e.g., 'inspect the generated spec JSON or render the preview format first when the user is unsure' — and a one-line example invocation of build_chat_overlay_spec.py showing transcript + config arguments.

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence, but the avatar policy is stated twice (Workflow step 1 and Output Rules), the deliveryFormat labels with Chinese annotations are repeated verbatim in step 5 and Supported Dimensions, and the Question Policy section partially duplicates references/question-strategy.md. Minor redundancy that could be trimmed — anchor 4, not 5's 'every token earns its place', and clearly above anchor 3's 'some unnecessary explanation'.

4 / 5

Actionability

Concrete executable guidance throughout: exact script paths ('scripts/build_chat_overlay_spec.py', 'scripts/prepare_chat_overlay_bundle.py') and delegation to output-modes.md, which contains full copy-paste npx remotion render commands. Minor gap: no example invocation showing how to pass a transcript and config to the spec script, so it is 'mostly executable' per anchor 4 rather than fully copy-paste ready per anchor 5.

4 / 5

Workflow Clarity

A clear five-step sequence (normalize input → choose config → build spec → prepare bundle → render) with decision points surfaced via the question policy. However, there is no explicit validation checkpoint (e.g., verify the generated spec JSON or render a preview before final export), matching anchor 4's 'clear sequence with most checkpoints present; minor validation gaps' rather than anchor 5's explicit validate-then-proceed loop. The destructive/batch cap does not apply since this is a generative, non-destructive task.

4 / 5

Progressive Disclosure

The body is a genuine overview with a Resources section pointing to real one-level-deep files (references/input-format.md, config-schema.md, question-strategy.md, output-modes.md, two scripts, assets/remotion-template/ — all verified to exist). The main organization gap is the 'Supported Dimensions' section inlining option enumerations that belong in references/config-schema.md, and the duplicated Question Policy content, keeping it at anchor 4 rather than 5's cleanly split structure.

4 / 5

Total

16

/

20

Passed

Description

92%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: specific, third-person, with an explicit 'Use when...' clause and concrete scenario triggers. The only weakness is that the most natural user phrases (animated chat, chat bubbles, message overlay) live in the triggers field instead of the description text, slightly weakening trigger-term coverage.

Suggestions

Fold one or two of the most natural user phrases (e.g., 'animated chat', 'chat bubbles', 'message overlay') from the triggers field into the description sentence itself so trigger-term coverage is complete within the description.

Consider naming the most common delivery outcomes (transparent MOV/WebM) in the description so users asking for 'transparent chat video' by result rather than by tool match immediately.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete capabilities — 'plain bubble scenes, app-style chat containers, optional device frames, preset or uploaded avatars, nickname display rules, and transparent-video-ready Remotion bundles' — and names both input sources (transcript or screenshot). This matches the anchor for comprehensive specific actions; the anchor below (4) is for minor coverage gaps that this does not exhibit.

5 / 5

Completeness

It clearly answers 'what' (generate configurable chat motion overlays with enumerated feature types) and 'when' via the explicit clause 'Use when Codex needs to create reusable short-form chat clips for Douyin, demo videos, story reenactments, social-message proof scenes, or embeddable alpha overlays'. Both what and when are explicit with concrete trigger scenarios, matching anchor 5; anchor 4 requires a weaker or less specific 'when'.

5 / 5

Trigger Term Quality

The description contains good natural keywords ('chat motion overlays', 'chat clips', 'alpha overlays', 'story reenactments', 'demo videos'), but several phrases a user would naturally say ('animated chat', 'chat bubbles', 'message overlay', 'chat video') appear only in the triggers field rather than in the description text itself. Good coverage with a few natural terms missing, matching anchor 4 rather than the comprehensive synonym/extension coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — transparent chat-overlay video generation for Remotion/Hyperframe workflows and Douyin-style clips — with distinct triggers that would rarely collide with other skills. Minimal conflict risk, matching anchor 5 rather than the minor-overlap wording of anchor 4.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
nexu-io/open-design
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.