media-generation-guide

Use Hana Media Generation tools for image and video generation. Read before calling media_generate-image, media_generate-video, or media_describe-options.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

100%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-organized, lean, and highly actionable guide that covers tool parameters, intent routing, and usage rules without padding. It fully satisfies the rubric across all four dimensions for a simple instruction-only skill.

Dimension	Reasoning	Score
Conciseness	The body is lean throughout, assuming Claude's competence and adding only non-obvious guidance (async behavior, session_file preference, 'do not put mode values in model') without explaining concepts Claude already knows.	3 / 3
Actionability	Guidance is concrete and specific — exact reference shapes, explicit omit-unless conditions for advanced overrides, and an intent-to-tool routing table — giving copy-ready, actionable direction for an instruction-only skill.	3 / 3
Workflow Clarity	The single async generation action is unambiguous (submit, tell the user, do not wait or call stage_files, media appears automatically), with a clear conditional flow for media_describe-options and no destructive/batch steps requiring validation loops.	3 / 3
Progressive Disclosure	The skill is under 50 lines, needs no external references, and is organized into clear sections (Tools, Routing, Rules), which satisfies the simple-skill progressive-disclosure criterion.	3 / 3
	Total	12 / 12 Passed

Description

75%Weight 40%Scale 1-3

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description clearly states the skill's purpose and gives explicit, tool-based trigger guidance, making it distinct and complete. It is slightly weak on specificity and natural trigger terms, leaning on tool-name jargon over user-facing language.

Suggestions

Expand the capability list beyond 'image and video generation' to name the concrete sub-actions (e.g., edit/restyle a reference image, blend multiple references, animate an image) so specificity reaches the comprehensive anchor.

Add natural user-facing trigger terms alongside the tool names (e.g., 'Use when the user wants to generate, edit, or animate images or videos') so trigger_term_quality covers common phrasings users actually say.

Dimension	Reasoning	Score
Specificity	It names the domain ('image and video generation') and the three media tools, but does not enumerate the sub-capabilities (edit, restyle, blend, animate) that the body covers, so it names some actions rather than a comprehensive list.	2 / 3
Completeness	'image and video generation' answers what the skill does, and 'Read before calling media_generate-image, media_generate-video, or media_describe-options' is explicit trigger guidance equivalent to a 'Use when' clause, so it clearly answers both what and when.	3 / 3
Trigger Term Quality	'image and video generation' are relevant natural terms, but the description is dominated by tool-name jargon ('media_generate-image', 'media_describe-options') that users would not say, and common variations ('make a picture', 'create a video') are missing.	2 / 3
Distinctiveness Conflict Risk	The description targets a clear niche (Hana Media Generation via three named tools) with distinct triggers, making it unlikely to fire for unrelated skills.	3 / 3
	Total	10 / 12 Passed

Validation

100%

Warnings & errors only

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: liliMozi/openhanako
Path: plugins/media/skills/media-generation-guide/SKILL.md
Commit: b6ab4ad

Reviewed: 12 days ago

Table of Contents

Discovery Implementation Validation

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.