← LeaderboardThe Skill Leaderboard

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.

Published by aipoch ↗aipoch/medical-research-skills

Try your first task

kv-design

Start a fresh conversation. Replace the highlighted placeholders.

Use kv-design to propose three KV design directions and image-generation-ready prompts for [brand/campaign], using [slogan/copy] and [usage scenario], with planned negative space and the intended style, color, and aspect ratio.

Required inputs

  • [brand/campaign]
  • [slogan/copy]
  • [usage scenario]

User-approved starter prompt based on a pinned source version; check current skill requirements before running. Task evidence ↗

SKILL.md

name: kv-designdescription: 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: MITauthor: 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

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:

    export ZHIPUAI_API_KEY="YOUR_KEY_HERE"

  2. Run the script with the generated prompt:

    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.
kv-design by aipoch · The Skill Leaderboard