CommunityCoding & Developmentgithub.com

Visual Prompt Builder

Produces AI image/video generation prompts (text only, no image generation). Narrows down requirements through one-question-at-a-time sessions, then outputs a complete prompt ready to paste into Gemini, Midjourney, Qianwen, Jimeng, and other tools, based on a built-in 8-field framework, character consistency prefixes, style recipes, and a negative list.

What is Visual Prompt Builder?

This skill, Visual Prompt Builder, helps developers and AI agent users transform vague visual ideas into structured, actionable prompts for AI image and video generation tools. It specializes in converting user intents like 'make me a picture' or 'I want this feeling' into a complete prompt without actually generating images. The skill operates through an interactive, step-by-step process: it first judges the type of output needed (static image, product short video, character consistency, or reverse engineering from reference), then asks one question at a time to fill in key fields (subject, scene, style, etc.), shows a draft for confirmation, and finally outputs a full prompt with a negative list and usage tips. It supports platforms such as Gemini, Midjourney, Qianwen, and Jimeng, and strategically chooses the output language (Chinese for conversational models, English for keyword-based ones). The skill's core strength lies in its ability to infer as much as possible from the user's initial request, minimizing back-and-forth while ensuring the final prompt is both precise and ready-to-use, making it a powerful asset for any developer working with AI visual generation pipelines.

Works with~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/goingli0324/visual-prompt-builder/tree/main

Installed? Explore more Coding & Development skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

What does Visual Prompt Builder do?

Refine a vague idea ("I want a cute picture") into an actionable prompt.

This Skill's output is text only. After generating the prompt, hand it over to the user to paste into their generation tool; no image generation API is called, and no images are generated on behalf. If the user asks for direct generation, explain that this Skill only produces prompts and suggest pasting the output into their preferred tool.

Core Principles

  1. Don't ask what you can infer. Fill in fields that can be deduced from the user's statement directly; only ask questions that will actually change the result.
  2. One question at a time. Offer suggested answers and a brief rationale for each question, so the user can simply respond with "ok" or "no, because…". Asking three or more questions in a row will overwhelm the user.
  3. Draft first, then full text. Once fields are collected, present a 3–5 line direction draft for the user to confirm before expanding into the full prompt.
  4. Use the structure, write your own content. The built-in files provide a skeleton and keyword library, not canned answers. Do not copy the subject or scene from a reference example directly onto a new request.

Workflow

Step 1: Determine the Path

Determine the category based on the user's input. If you can infer it, don't ask:

PathTrigger SignalsWhich Reference to Read
A. Static Image"A picture" "avatar" "cover" "poster" "figure/collectible"references/frameworks.md, references/style-library.md
B. Product Short VideoProduct mentioned, selling something, mentions seconds/voiceover/storyboard/e-commerce platformreferences/video-structure.md
C. Character Consistency ContinuationExisting costume images, "same person" "don't change face" "make them move"references/character-lock.md
D. Reverse EngineeringGiven a reference image/video saying "I want this style"references/frameworks.md §4 Reverse Engineering Process

If you cannot determine the path, this is the first and only question you should ask about the path.

Step 2: Collect Fields (One Question at a Time)

Static Image — three mandatory questions, the rest use defaults:

  1. Who or what is the subject? — No default; must ask. Drill down to specifics: age, attire, demeanor, quantity.
  2. Where is the scene? — Can infer a suggestion from the subject (e.g., figure/collectible → miniature scene/display stand).
  3. Style and mood? — Offer 2–3 distinctly different directions for the user to choose from; do not list five slight variations.

Defaults (do not ask, but mark them in the draft; user can override):

  • Aspect ratio: 9:16 (short video & social) / 1:1 (IG post) / 16:9 (presentation & YouTube) — auto-selected based on use case.
  • Lighting: cinematic lighting + one additional style-appropriate light (soft light/rim light/volumetric light).
  • Image quality parameters: ultra detailed, 8K, high detail.
  • Negative list: always included; see references/negative-prompts.md.

Product Short Video — mandatory: what is the product, duration (default 10 seconds), whether voiceover is needed (default yes), platform (determines aspect ratio).

Character Consistency — mandatory: to what degree of consistency (see intensity levels in references/character-lock.md), and whether to change costume/scene.

Step 3: Draft Confirmation

Provide a short draft in this format:

Direction: <one-sentence description of the image>
Subject: <> / Scene: <> / Style: <> / Aspect Ratio: <>
Will include: <character lock? negative list? storyboard?>

Is this correct? What needs to change?

Proceed to Step 4 only after the user confirms. Do not expand to full text without confirmation.

Step 4: Output

Must include the following sections; do not force any that are missing:

  • Main Prompt — placed inside a code block for easy copying.
  • Negative Prompt / Negative List — a separate paragraph.
  • (Video) Storyboard — mark the time in seconds, write the visual for each segment.
  • (Video) Voiceover Script — a separate paragraph, for easy voice recording.
  • One-liner Usage Tip — suggest which tool to paste into, and which field might need manual adjustment.

Output language depends on the target tool: for conversational models like Gemini / ChatGPT / Qianwen, use Chinese; for pure keyword models like Midjourney, use English. If unsure, provide both versions with Chinese first.

Reference Files

FileContentWhen to Read
references/frameworks.mdEight-field fill-in table, layout methods, style naming conventions, reverse engineering processAlmost every time
references/style-library.mdKeyword strings and example skeletons for eight style recipesAfter selecting the style, read the relevant section
references/character-lock.mdWriting structure for character locking and examples for each intensity levelPath C, or any request that requires preserving a real person's appearance
references/video-structure.mdVideo storyboard structure, voiceover writing, compliance sentence patterns, action continuity constraintsPath B, or any video-related request
references/negative-prompts.mdCategorized negative lists (Chinese and English)Before every output, read and select relevant items

Boundaries

  • Does not generate images or videos; only produces text.
  • Does not assist in generating false imagery of real people or creating misleading content.
  • For product-related prompts involving food, health supplements, or medical devices, must include compliance sentence patterns (see references/video-structure.md §4); do not write efficacy guarantees or fabricate discounts.
  • Referencing another creator's style is allowed; explicitly mimicking the personal style of a specific living creator requires reminding the user to make their own judgment.
  • Prompts are often tied to a specific tool's behavior at a specific time; effects may change after model updates. Use the examples as structural templates, not as guaranteed incantations.

Related Skills