SuperAPI AI Directory

visual-style

Design & creation

View repository

Updated 10-16 01:18

About this skill

/visual-style — Visual Brand Identity Builder

Every brand has a voice. This skill gives it eyes.

Voice-profile.md defines how the brand sounds. Visual Brand Style defines how it looks — the lighting, the composition, the mood that makes someone see an image and know it's yours before reading a word.


On Activation

  1. Read brand/creative-kit.md if it exists. Check for a ## Visual Brand Style section.
    • If the section exists and is populated (not template comments): Refresh mode — show current style, offer to update or replace.
    • If the section is template/empty: Create mode — build from scratch.
    • If creative-kit.md doesn't exist: create it first with mktg init, then proceed.
  2. Read brand/voice-profile.md if it exists — personality informs visual tone (e.g., playful voice = warm/bright visuals, authoritative = clean/precise).
  3. Read brand/positioning.md if it exists — angles inform visual metaphors (e.g., "the simple alternative" = minimalist aesthetic).
  4. If no brand files exist, proceed anyway — ask the user directly. Progressive enhancement, not gating.

Mode Selection

Use AskUserQuestion:

"How do you want to define your visual brand style?"

  1. Extract — I'll analyze your website or existing assets to derive the visual identity
  2. Build — I'll interview you about your visual preferences (5-7 questions)
  3. Reference — You provide mood boards, example images, or reference URLs and I'll synthesize a style

Mode 1: Extract

The user provides a URL or set of URLs (website, landing page, social profiles).

  1. Use WebFetch to scrape each URL.
  2. Analyze for visual patterns:
    • Dominant colors (map to hex codes)
    • Typography (serif vs sans-serif, weight, spacing)
    • Photography style (studio, candid, illustration, none)
    • Layout patterns (dense, airy, grid-heavy, asymmetric)
    • Mood (corporate, playful, premium, technical, warm)
  3. Synthesize findings into the Visual Brand Style format.
  4. Present to user via AskUserQuestion: "Here's what I extracted from your site. Does this capture your visual brand, or should I adjust?"

Fallback: If WebFetch is unavailable, switch to Build mode and tell the user why.


Mode 2: Build

Interview the user. Ask one question at a time via AskUserQuestion.

Question 1: Aesthetic anchor "Pick the closest match to how your brand should look visually:"

  • Minimal and clean (Apple, Stripe)
  • Warm and human (Mailchimp, Notion)
  • Bold and energetic (Figma, Vercel)
  • Premium and dark (Linear, Raycast)
  • Editorial and photographic (Medium, Substack)
  • Something else (describe it)

Question 2: Lighting and mood "What lighting feels right for your brand's images?"

  • Warm and golden (golden hour, ambient glow)
  • Bright and airy (soft diffused, clean whites)
  • Dramatic and contrasty (rim lighting, dark backgrounds)
  • Natural and candid (daylight, real environments)
  • Neon and digital (glowing screens, dark mode)

Question 3: Composition "How should images be composed?"

  • Single focal point with lots of breathing room
  • Rich and detailed — fill the frame
  • Asymmetric and editorial — off-center subjects
  • Geometric and structured — grid-aligned elements

Question 4: What to avoid "What should your images NEVER look like?" (Free text — the user's avoidances are often more revealing than their preferences)

Question 5: Reference "Name a brand, website, or aesthetic that captures what you're going for — even if it's in a completely different industry."

Optional Question 6: Existing assets "Do you have any images that already feel on-brand? Describe them or share URLs."

Synthesize answers into the Visual Brand Style format.


Mode 3: Reference

The user provides mood boards, image URLs, or descriptions of their ideal visual style.

  1. If URLs: use WebFetch or Read to analyze the images/pages.
  2. If descriptions: extract the key visual patterns.
  3. Synthesize into Visual Brand Style format.
  4. Present for confirmation.

Output Format

Write the ## Visual Brand Style section into brand/creative-kit.md. Preserve all existing sections (Brand Colors, Typography, Visual Style). Only add/update the Visual Brand Style section.

## Visual Brand Style

- **Primary Aesthetic:** [derived aesthetic, e.g., "warm tech minimalism with editorial photography"]
- **Lighting:** [specific lighting direction, e.g., "soft diffused with rim lighting accents, warm color temperature"]
- **Backgrounds:** [background treatment, e.g., "dark slate (#0F172A) with warm accent gradients"]
- **Composition:** [layout approach, e.g., "single focal point, generous negative space for text overlay"]
- **Mood:** [emotional tone, e.g., "calm empowerment — powerful but approachable, like a quiet expert"]
- **Avoid:** [explicit exclusions, e.g., "generic stock photos, cold blue tech grids, floating 3D cubes, busy compositions"]
- **Reference Prompts:**
  1. [A proven prompt that captures the brand look — ready to paste into image gen]
  2. [A second prompt showing a different use case in the same style]
  3. [Optional third prompt for edge cases]

Reference Prompts are critical. These are the style anchors that /image-gen uses when generating on-brand images. They should be complete, narrative prompts (not keywords) that produce images distinctly this brand.


Refresh Mode

When ## Visual Brand Style already exists:

  1. Present the current style summary.
  2. AskUserQuestion: "Your visual brand style was last defined [date]. What would you like to do?"
    • Update specific fields (which ones?)
    • Rebuild from scratch
    • Add new reference prompts
    • Keep it as-is

Progressive Enhancement

Level Context Output quality
L0 No brand files Generic but functional — asks user directly, writes style from scratch
L1 voice-profile.md exists Personality-aligned — playful voice gets warm visuals
L2 + creative-kit.md colors/typography Color-constrained — prompts incorporate brand palette
L3 + positioning.md Full alignment — visual metaphors match positioning angles

Anti-Patterns

Anti-pattern Why it fails Instead
Locking into one rigid style Brands need versatility — a blog header and an error page shouldn't look identical Define the core aesthetic but include "also works for: [alternative moods]" in reference prompts
Ignoring existing creative-kit.md sections Overwriting colors/typography the user already defined breaks trust and loses work Read and preserve existing sections, only add/update Visual Brand Style
Generic descriptions like "modern and clean" Every brand says this — it gives image-gen nothing to work with Be specific: "warm rim lighting on dark backgrounds, single subject, f/2.0 bokeh"
Skipping the Avoid list What to avoid is often more distinctive than what to include — it prevents the generic Always ask what the brand should NEVER look like
Writing keyword prompts instead of narrative Image gen models produce better results from flowing descriptions than comma-separated terms Reference prompts should read like a scene description, not a tag list

Related Skills

  • /image-gen — reads the Visual Brand Style this skill creates to generate on-brand images
  • /brand-voice — builds the verbal identity; visual-style builds the visual identity
  • /creative — produces multi-mode creative briefs that reference creative-kit.md
  • /paper-marketing — designs in Paper MCP using creative-kit.md for design system