Agent skill

Kv Design

by aipoch in aipoch/medical-research-skills

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.

MITAuto-check passedMedia & Creative

Install Kv Design

skills CLI
$ npx skills add aipoch/medical-research-skills --skill kv-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aipoch/medical-research-skills kv-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aipoch/medical-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/scientific-skills/Other/kv-design .claude/skills/kv-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kv-design
GitHub stars
2k
Token cost
~974 tokens
SKILL.md length
413 words
Files
4 (incl. scripts, references)
Skills in repo
567
Repo updated
First seen
Licence
MIT

At a glance

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.

  • Works in 4 steps: Collect KV Requirements → Analyze the Design Direction → Generate the KV Image Prompt → …
  • You have a slogan/copy and a marketing scenario but need a clear visual direction and a ready-to-generate image prompt
  • SKILL.md covers When to Use, Key Features, Dependencies and Example Usage, plus 1 more section
  • Runs Python scripts from its folder; calls python; needs ZHIPUAI_API_KEY

What it does

Kv Design is an agent skill from aipoch/medical-research-skills. 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.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `kv-design_audit_result_v1.json`, `references/design_prompts.md` and `scripts/generate_kv.py`).

It sits in Media & Creative, covering Image generation and Proposals and quotes. The repository describes itself as: Hundreds of agent skills for medical research, including protocol design, data analysis, evidence insights, and academic writing. The licence is MIT.

When your agent uses it

  • You have a slogan/copy and a marketing scenario but need a clear visual direction and a ready-to-generate image prompt
  • Tasks that involve Image generation
  • Tasks that involve Proposals and quotes

Example prompts

  • “/kv-design”

Requirements

  • Python 3
  • A credential in ZHIPUAI_API_KEY

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Collect KV Requirements
  2. Analyze the Design Direction
  3. Generate the KV Image Prompt
  4. Generate the KV Image (Runnable)

What it can do on your machine

Read from SKILL.md and the folder at commit 686e09d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ZHIPUAI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kv Design loads about 974 tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 51 tokens; SKILL.md has 413 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~974
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from aipoch/medical-research-skills at commit 686e09d, republished under its MIT licence (© aipoch). 413 words, ~974 tokens.

Download SKILL.mdSave it as .claude/skills/kv-design/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
kv-design
description
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.
license
MIT
author
AIPOCH

Source: https://github.com/aipoch/medical-research-skills

When to Use

  • Brand marketing campaigns where you need a hero visual that matches brand tone and supports headline/copy overlay.
  • Event promotions (e.g., seasonal sales, product launches) requiring a strong focal point and clear layout guidance.
  • Website/app banners that must fit specific aspect ratios and maintain readable negative space for text.
  • Social media hero creatives where you need fast iteration from vague requirements to a consistent visual direction.
  • Pitching multiple design directions to stakeholders (e.g., 2–3 KV concepts with distinct styles and compositions).

Key Features

  • Converts vague KV requirements into professional design directions (visual focus, layout suggestions, style details).
  • Produces image-generation-ready prompts optimized for KV composition and marketing readability.
  • Encourages negative space planning for copy placement and subject prominence for attention capture.
  • Supports common KV constraints: scenario-driven style, main color tone, and size/ratio intent.

Dependencies

  • Python 3.10+
  • Required Python packages:
    • zhipuai
    • requests
  • ZhipuAI API access via environment variable:
    • ZHIPUAI_API_KEY (required)

Example Usage

1) Collect KV Requirements

Prepare the following information:

  • Project/Brand Name
  • Core Slogan/Copy (the “soul” of the KV)
  • Usage Scenario (e.g., New Product Launch, Black Friday Sale, Website Banner)
  • Style Preference (e.g., 3D render, minimalist, illustration)
  • Main Color Tone
  • Size/Ratio Requirements (even if the script defaults to one, capture the user’s intent)
2) Analyze the Design Direction

Use the KV Design Analysis Prompts in:
references/design_prompts.md

Process:

  1. Open KV Design Analysis Prompts.
  2. Fill in the collected information into [KV Design Requirements].
  3. Generate:
    • Visual Focus
    • Layout Suggestions
    • Style Details
Show full SKILL.md (177 more words)Show less
3) Generate the KV Image Prompt

Use the KV Image Prompt Generation Prompts in:
references/design_prompts.md

Process:

  1. Open KV Image Prompt Generation Prompts.
  2. Fill in:
    • [Basic Requirements]
    • [Design Proposal] (from Step 2)
  3. Generate the final optimized image prompt.
4) Generate the KV Image (Runnable)
  1. Ensure the API key is set:

    bash
    export ZHIPUAI_API_KEY="YOUR_KEY_HERE"
  2. Run the script with the generated prompt:

    bash
    python scripts/generate_kv.py "<generated_prompt>"
  3. After completion, return the generated image file path to the user.

Implementation Details

  • Two-stage prompting workflow

    1. Design analysis stage: transforms requirements into actionable design guidance (focus, layout, style).
    2. Prompt generation stage: converts the design guidance into a production-ready image prompt.
  • KV composition constraints

    • Negative space: reserve clean areas for headline/subcopy overlays; avoid overly busy backgrounds.
    • Subject prominence: ensure the primary subject (product/concept) is visually dominant and attention-grabbing.
  • Parameters to capture early

    • Scenario drives composition and tone (e.g., “sale” vs. “premium launch”).
    • Style preference constrains rendering approach (3D/illustration/minimal).
    • Main color tone ensures brand consistency.
    • Aspect ratio/size intent informs layout planning even if generation defaults to a preset.

© aipoch, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in scientific-skills/Other/kv-design of aipoch/medical-research-skills.

  • SKILL.md
  • kv-design_audit_result_v1.json
  • references/design_prompts.md
  • scripts/generate_kv.py

Open the folder on GitHubat commit 686e09d

Compare with similar skills

Kv Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kv Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kv Design this skillaipoch/medical-research-skills2k—~974Automated safety check: PassMIT
Ecom ShotMagicCube/agentara516—~1.5kAutomated safety check: PassNone
Commercial Media Productionfal-ai-community/skills249—~1.5kAutomated safety check: PassNone
Ad ReadyLeoYeAI/openclaw-master-skills2.2k—~5.4kAutomated safety check: PassMIT
SEO Image GeneratorAgriciDaniel/claude-seo18k2 repos~2.1kAutomated safety check: PassMIT
Xhs Visual Directorziguishian/xhs-visual-director-skill1.4k—~2.2kAutomated safety check: PassMIT

Similar skills

  • Ecom Shot

    MagicCube/agentara

    Generate Nano Banana Pro (Gemini 3 Pro Image) prompts for e-commerce product photography.

    516 GitHub stars~1.5k tokensUpdated 5 mo ago
    Media & CreativeAuto-check passed
  • Commercial Media Production

    fal-ai-community/skills

    Plans and runs commercial image and video production with the genmedia CLI: product shots, ads, e-commerce batches, product reveals and background replacement.

    249 GitHub stars~1.5k tokensUpdated 10 days ago
    Media & CreativeAuto-check passed
  • Ad Ready

    LeoYeAI/openclaw-master-skills

    Generate advertising images automatically from a product URL + brand profile.

    2.2k GitHub stars~5.4k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • SEO Image Generator

    AgriciDaniel/claude-seo

    Generates Open Graph previews, blog hero images, product photos and infographics for SEO use through Gemini image tools and the banana extension.

    18k GitHub starsUsed in 2 repos~2.1k tokens
    Media & CreativeAuto-check passed
  • Xhs Visual Director

    ziguishian/xhs-visual-director-skill

    A skill your agent uses when planning, redesigning, or reviewing Xiaohongshu carousel visuals, covers, 3:4 image posts, page-by-page visual direction, image-generation prompts, style selection…

    1.4k GitHub stars~2.2k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed
  • Cover Anchor System

    ponyodong2026/ponyo-cover-anchor-system

    Designs Xiaohongshu and WeChat article covers around information density and a visual anchor, then writes a complete image prompt, color plan and critique.

    190 GitHub stars~1.1k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed

More from aipoch/medical-research-skills

All 567 skills in this repo
  • Academic Poster Generator

    aipoch/medical-research-skills

    Complete workflow for generating academic research posters from PDF literature; use when you need to extract paper content from PDFs and produce a LaTeX-based poster…

    2k GitHub stars~2.2k tokensUpdated 21 days ago
    Auto-check passed
  • Diagnostic Study Quality Assessment Quadas

    aipoch/medical-research-skills

    Analyzes clinical diagnostic accuracy studies for bias using the QUADAS-2 tool.

    2k GitHub stars~1.4k tokensUpdated 21 days ago
    Auto-check passed
  • Exploratory Data Analysis

    aipoch/medical-research-skills

    Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats.

    2k GitHub stars~3.7k tokensUpdated 21 days ago
    Auto-check passed
  • Iso Certification

    aipoch/medical-research-skills

    A toolkit for preparing ISO 13485:2016 certification documentation for medical device QMS.

    2k GitHub stars~1.8k tokensUpdated 21 days ago
    Auto-check passed
  • Journal Skills

    aipoch/medical-research-skills

    Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal…

    2k GitHub stars~1.7k tokensUpdated 21 days ago
    Auto-check passed
  • Latex Posters

    aipoch/medical-research-skills

    Creates academic-poster writing packages for LaTeX using beamerposter, tikzposter, or baposter.

    2k GitHub stars~1.3k tokensUpdated 21 days ago
    Auto-check passed

Questions about Kv Design

What does Kv Design do?

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. Kv Design is an agent skill from aipoch/medical-research-skills. 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.

When should I use Kv Design?

Kv Design fits situations like: you have a slogan/copy and a marketing scenario but need a clear visual direction and a ready-to-generate image prompt; tasks that involve Image generation; tasks that involve Proposals and quotes.

How do I install Kv Design in Claude Code?

Run `npx skills add aipoch/medical-research-skills --skill kv-design -a claude-code`. Or copy the skill folder (scientific-skills/Other/kv-design in aipoch/medical-research-skills) into .claude/skills/kv-design in your project. Claude Code loads it when a task matches its description.

How do I install Kv Design in Codex?

Run `npx skills add aipoch/medical-research-skills --skill kv-design -a codex`. Or copy the skill folder (scientific-skills/Other/kv-design in aipoch/medical-research-skills) into .agents/skills/kv-design in your project. Codex loads it when a task matches its description.

Can I use Kv Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aipoch/medical-research-skills --skill kv-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kv-design, .gemini/skills/kv-design, .github/skills/kv-design and .opencode/skills/kv-design in your project.

What does Kv Design need to run?

Going by SKILL.md and its folder, Kv Design needs Python for the scripts in its folder, the command-line tools its instructions call (python) and credentials named ZHIPUAI_API_KEY. Our summary lists: Python 3; A credential in ZHIPUAI_API_KEY.

Does Kv Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Kv Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Kv Design use?

Kv Design is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kv Design use?

About 974 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 633 tokens, read only when the agent opens those files.

What are the alternatives to Kv Design?

Skills that share tags, products or a category with Kv Design: Ecom Shot (MagicCube/agentara, 516 stars), Commercial Media Production (fal-ai-community/skills, 249 stars), Ad Ready (LeoYeAI/openclaw-master-skills, 2.2k stars) and SEO Image Generator (AgriciDaniel/claude-seo, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kv Design?

aipoch (a GitHub organization) maintains it in aipoch/medical-research-skills, which has 1,974 GitHub stars. The repository holds 567 skills in this directory. The repository was last updated on September 17, 2026.

Source: aipoch/medical-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.