CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

media-gen

Generate or edit images, videos, or audio in the current task. Use whenever the user asks to create/generate/produce or edit/modify a picture / image / illustration / cover / poster / icon / artwork, a video / clip / animation, or speech / voiceover / narration / TTS / ambient audio / soundscapes — e.g. generate image, draw, design a cover, edit this image, change the background, text-to-video, generate speech; 画一张, 配图, 编辑图片, 改图, 换背景, 做个视频, 配音, 文字转语音, 环境音. Also use when a document (slides, poster, README hero) needs an inline image.

Quality

82%

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

70%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 operational reference in terms of executability and error-recovery workflow, covering generate/edit for images, video (including async Seedance), and speech with concrete commands and validation loops. Its weaknesses are systematic repetition across modality sections, a vague ambient-audio stub, and a monolithic single-file structure that should split per-modality details into reference files.

Suggestions

Split the per-modality details into one-level-deep reference files (e.g. references/video-seedance.md for the two Seedance field tables, capability matrix, and async polling; references/audio-tts.md for the speech API), keeping SKILL.md as an overview with per-modality quick-start examples.

Deduplicate repeated guidance: state the output_dir and session_id field semantics once, and compress the Seedance cost-gate paragraph to a single 'ask the user for resolution before every billable call; never reuse a prior answer' instruction instead of four bolded restatements.

Either make 'Generating ambient audio' actionable (endpoint, request fields, response shape, as done for speech) or remove the section and fold ambient-audio triggers into the speech/TTS section.

DimensionReasoningScore

Conciseness

Mostly earns its tokens (API specifics Claude cannot know), but there is real padding: the Seedance cost-gate paragraph restates 'ask before every generation' roughly four times in bold, and the output_dir and session_id table rows are repeated verbatim across three request tables. Fits anchor 3 — efficient in places but could be tightened — rather than 4, because the repetition is systematic, not incidental.

3 / 5

Actionability

Nearly everything is copy-paste executable: complete curl commands, request-field tables, success/failure response shapes, per-error_type handling, a ready poll loop, and a real helper script whose documented subcommands match. It stops short of 5 because the 'Generating ambient audio' section is a non-actionable stub ('Generate it programmatically, verify the audio') with no endpoint, fields, or commands.

4 / 5

Workflow Clarity

Clear numbered sequences with explicit validation and feedback loops throughout: verify backend via /api/media/types before any call, magick identify verification for exact sizes, content_filter rephrase-and-retry (up to 3), 400 fallback of dropping aspect_ratio, a full Seedance status-poll loop with hard no-resubmit rules, a 15-minute polling cutoff, and a 6-step last-frame chaining workflow.

5 / 5

Progressive Disclosure

Internal sectioning is clear and the single bundle file (scripts/video_seq.sh) is real and well-signaled, but ~600 lines inlining three distinct sub-APIs (image, Veo video, Seedance video with two field tables and async polling, TTS) in SKILL.md is content that clearly belongs in one-level-deep reference files. Anchor 3 — some structure, but content that should be separate is inline.

3 / 5

Total

15

/

20

Passed

Description

91%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 that explicitly states capability and triggers with comprehensive bilingual synonym coverage and an explicit 'Use whenever...' clause. The only weaknesses are a thin action-verb list (generate/edit only) and minor trigger overlap with non-generative image-editing intents.

DimensionReasoningScore

Specificity

"Generate or edit images, videos, or audio in the current task" names two concrete actions applied across all three covered media domains, with complete coverage of the skill's surface. It falls at anchor 4 rather than 5 because only two distinct action verbs are listed, unlike the multi-action comprehensiveness of the 5 anchor.

4 / 5

Completeness

Explicitly answers both questions: the what ("Generate or edit images, videos, or audio in the current task") and the when with concrete trigger phrases ("Use whenever the user asks to create/generate/produce or edit/modify ...", "Also use when a document (slides, poster, README hero) needs an inline image"), in third-person voice.

5 / 5

Trigger Term Quality

Exhaustive natural-term coverage with synonyms and even bilingual variants: "picture / image / illustration / cover / poster / icon / artwork", "video / clip / animation", "speech / voiceover / narration / TTS / ambient audio / soundscapes", example phrases like "generate image, draw, ... text-to-video, generate speech" and Chinese triggers "画一张, 配图, 做个视频, 配音, 文字转语音, 环境音".

5 / 5

Distinctiveness Conflict Risk

Media generation is a clear niche with distinctive triggers (TTS, text-to-video, ambient audio, soundscapes), but "edit/modify a picture", "change the background", and "icon" could also fire for a non-generative image-manipulation or vector-graphics skill — minor overlap risk with closely related skills rather than the minimal risk of anchor 5.

4 / 5

Total

18

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (618 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 3 suspicious

Warning

Total

13

/

16

Passed

Repository

clacky-ai/openclacky

Path

lib/clacky/default_skills/media-gen/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.