kv-design

Generate professional Key Visual (KV) design proposals and images; use when you have a slogan/copy and a marketing scenario but need a clear visual direction and a ready-to-generate image prompt.

Quality

83%

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

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

The body is a well-structured, actionable overview with clean progressive disclosure to real reference and script files. Its main weakness is the absence of explicit validation/error-recovery checkpoints in the runnable image-generation step.

Suggestions

Add a validation checkpoint to Step 4, e.g. verify the script exited cleanly and confirm the returned image path exists before reporting success, with a retry hint on API failure.

Trim the marketing-toned framing in 'Key Features' ('Converts vague KV requirements into professional design directions') to tighter instructional phrasing.

Add a brief note on how to handle the ZHIPUAI_API_KEY being unset or the API call failing, to close the workflow_clarity validation gap.

Dimension	Reasoning	Score
Conciseness	The body is lean and avoids explaining concepts Claude already knows, but the 'When to Use' and 'Key Features' sections carry mild marketing tone ('Converts vague KV requirements into professional design directions') that could be trimmed for token efficiency.	4 / 5
Actionability	Step 4 is copy-paste ready (export ZHIPUAI_API_KEY; python scripts/generate_kv.py "<generated_prompt>") and Steps 1-3 give concrete field lists and fill-in markers, though the actual prompt templates are deferred to the reference file rather than shown inline.	4 / 5
Workflow Clarity	A clear 4-step sequence (collect -> analyze direction -> generate prompt -> generate image) with concrete commands, but no explicit validation or error-recovery checkpoints (e.g. verifying the image generated or handling API failures).	4 / 5
Progressive Disclosure	Well-organized sections with clearly signaled one-level-deep references to references/design_prompts.md and scripts/generate_kv.py (both real files), keeping prompt templates and the runnable script appropriately split out of the overview.	5 / 5
	Total	17 / 20 Passed

Description

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

The description is strong: it clearly states what the skill does and gives an explicit, concrete 'use when' trigger tied to slogan/copy and marketing scenarios. It carves a distinct KV-design niche with low conflict risk, with only minor room to add more natural trigger synonyms.

Dimension	Reasoning	Score
Specificity	Names the KV domain and three concrete actions ("Generate professional Key Visual (KV) design proposals and images", "ready-to-generate image prompt"), but the actions stay somewhat high-level rather than exhaustively enumerated.	4 / 5
Completeness	Explicitly answers both what ("Generate professional Key Visual (KV) design proposals and images") and when ("use when you have a slogan/copy and a marketing scenario but need a clear visual direction and a ready-to-generate image prompt") with concrete trigger conditions.	5 / 5
Trigger Term Quality	Includes natural marketing phrases ("slogan/copy", "marketing scenario", "Key Visual (KV)", "visual direction", "image prompt"), though common synonyms a user might say like "banner", "poster", or "ad creative" are absent.	4 / 5
Distinctiveness Conflict Risk	"Key Visual (KV) design" with slogan/copy and marketing-scenario triggers carves out a distinct niche with minimal overlap against generic image-generation or copywriting skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: aipoch/medical-research-skills
Path: scientific-skills/Other/kv-design/SKILL.md
Commit: f5ef65b

Reviewed: ~16 hours 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.