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.
Best use case
kv-design is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
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.
Teams using kv-design should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/kv-design/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How kv-design Compares
| Feature / Agent | kv-design | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill 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.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
> **Source**: [https://github.com/aipoch/medical-research-skills](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** ### 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.
Related Skills
clinic-research-design
Generates a structured prompt framework for clinical study protocols. Supports Diagnostic, Efficacy, Etiology, and Prognosis studies. Calculates sample size and provides logic guides for LLMs.
basic-research-design
A biomedical research topic designer that generates progressive experimental subtitles and detailed research outlines based on a given subject. Use when the user wants to design a research proposal, outline experiments for a topic, or structure a biomedical study.
poster-designer
Generate professional poster design concepts and optimized image-generation prompts, then automatically run a drawing script to produce the final poster image when a user needs a poster.
api-design-principles
Principles and checklists for designing and reviewing REST and GraphQL APIs; use when defining or evaluating API contracts (endpoints/schemas), naming, error models, pagination, versioning, and REST vs. GraphQL trade-offs.
study-design-scale-selector
Determines the appropriate Risk of Bias assessment scale for a medical study based on its design (RCT, Cohort, etc.), using PubMed metadata lookup or text analysis. Use when the user wants to know which quality assessment tool to use for a specific paper (given PMID or abstract).
validation-strategy-designer
Designs internal, external, temporal, and functional validation strategies at the protocol stage for medical research studies.
real-world-evidence-study-designer
Designs a structured real-world evidence study using EHR, claims, or registry data, with explicit handling of time zero, eligibility windows, exposure definitions, outcome windows, censoring, confounding control, and target-trial-emulation logic. Use this skill when the user needs study-type design and protocol framing for an observational clinical study based on routine-care data. Do not invent database fields, follow-up completeness, linkage, coding validity, or causal identifiability.
prognostic-biomarker-protocol-designer
Designs discovery, modeling, and validation workflows for prognostic biomarkers in biomedical and clinical research. Always use this skill when the user needs a prognostic biomarker study blueprint rather than a diagnostic test protocol, predictive biomarker design, treatment recommendation, or a completed manuscript. Focus on endpoint family, follow-up horizon, time scale, candidate marker strategy, model-building logic, risk stratification framework, and internal/external validation requirements. Do not invent cohort size, event rate, assay readiness, literature support, or validation access.
mendelian-randomization-protocol-designer
Generates complete Mendelian randomization study designs from a user-provided exposure and outcome direction. Always use this skill whenever a user wants to design, plan, or build a Mendelian randomization study — even if phrased as "help me write a paper on X", "design an MR study for Y", or "I want to test whether A causally affects B using GWAS". Covers core two-sample MR design, optional bidirectional follow-up, optional multivariable MR, IV selection logic, ancestry alignment, harmonization, IVW as the default primary estimator, weighted median / MR-Egger / MR-PRESSO / leave-one-out sensitivity analyses, Steiger directionality, heterogeneity / pleiotropy checks, and explicit claim-boundary control. Always outputs four workload configs (Lite / Standard / Advanced / Publication+) with a recommended primary plan, stepwise workflow, method rationale, validation ladder, figure plan, minimal executable version, and strictly verified literature guidance with no fabricated references.
endpoint-definition-designer
Designs primary, secondary, and exploratory endpoints for biomedical and clinical research protocols. Always use this skill when a user needs to translate study aims into operational endpoint definitions with event rules, assessment timing, composite logic, interpretability, and protocol-stage auditability. Focus on endpoint precision, feasibility, clinical meaning, ambiguity reduction, and implementation readiness rather than generic study design advice.
clinical-cohort-protocol-designer
Designs retrospective or prospective clinical cohort study protocols for biomedical and clinical research. Always use this skill when the user needs a cohort-based study plan rather than a general study idea, evidence summary, or mechanistic experiment design. Focus on cohort appropriateness, enrollment logic, baseline time-zero definition, follow-up structure, endpoint definition, variable collection, confounding control, and a coherent primary statistical analysis line. Do not invent data availability, follow-up completeness, outcome ascertainment quality, sample size adequacy, or causal interpretability.
aim-and-hypothesis-designer
Designs primary aims, secondary aims, and testable hypotheses from broad biomedical research ideas. Use this skill when a user needs to convert a loose study idea into a tighter protocol-framing structure with clear aim hierarchy, hypothesis discipline, and separation between hypothesis-driven and exploratory components. Always keep aims answerable, non-overlapping, and aligned to the intended evidence type and study scope.