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.

53 stars

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

$curl -o ~/.claude/skills/kv-design/SKILL.md --create-dirs "https://raw.githubusercontent.com/aipoch/medical-research-skills/main/scientific-skills/Other/kv-design/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/kv-design/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How kv-design Compares

Feature / Agentkv-designStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/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

53
from aipoch/medical-research-skills

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

53
from aipoch/medical-research-skills

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

53
from aipoch/medical-research-skills

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

53
from aipoch/medical-research-skills

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

53
from aipoch/medical-research-skills

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

53
from aipoch/medical-research-skills

Designs internal, external, temporal, and functional validation strategies at the protocol stage for medical research studies.

real-world-evidence-study-designer

53
from aipoch/medical-research-skills

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

53
from aipoch/medical-research-skills

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

53
from aipoch/medical-research-skills

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

53
from aipoch/medical-research-skills

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

53
from aipoch/medical-research-skills

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

53
from aipoch/medical-research-skills

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.