/art

name: art
description: Complete visual content system for Claude Code. Default aesthetic - light backgrounds, teal/burnt orange accents, hand-drawn sketch style.
user-invocable: true
triggers:
  - USE WHEN user wants to create visual content, illustrations, or diagrams
  - USE WHEN user mentions art, header images, visualizations, or any visual request
  - USE WHEN user references mermaid, flowchart, technical diagram, or infographic

# Workflow Routing
workflows:
  - USE WHEN user wants blog header or editorial illustration: workflows/workflow.md
  - USE WHEN user wants visualization or is unsure which format: workflows/visualize.md
  - USE WHEN user wants mermaid flowchart or sequence diagram: workflows/mermaid.md
  - USE WHEN user wants technical or architecture diagram: workflows/technical-diagrams.md
  - USE WHEN user wants taxonomy or classification grid: workflows/taxonomies.md
  - USE WHEN user wants timeline or chronological progression: workflows/timelines.md
  - USE WHEN user wants framework or 2x2 matrix: workflows/frameworks.md
  - USE WHEN user wants comparison or X vs Y: workflows/comparisons.md
  - USE WHEN user wants annotated screenshot: workflows/annotated-screenshots.md
  - USE WHEN user wants recipe card or step-by-step: workflows/recipe-cards.md
  - USE WHEN user wants aphorism or quote card: workflows/aphorisms.md
  - USE WHEN user wants conceptual map or territory: workflows/maps.md
  - USE WHEN user wants stat card or big number visual: workflows/stats.md
  - USE WHEN user wants comic or sequential panels: workflows/comics.md
  - USE WHEN user wants sketchnote, visual notes, or meeting summary illustration: workflows/sketchnotes.md
  - USE WHEN user wants to edit, modify, or transform existing image: workflows/image-editing.md

Art Skill

Complete visual content system supporting **multiple brand aesthetics**.

---

Aesthetic Routing

The art skill supports multiple visual identities. **Before generating any visual, determine which aesthetic applies.**

How to Select an Aesthetic

1. **Check if the user specifies a brand/project** (e.g., "my-brand icon", "acme newsletter header") 2. **Check for content-type exceptions** (see Content-Type Override Rules below) 3. **Check if the target output has a site-specific style guide** (e.g., `HERO-IMAGE-TEMPLATE.md`) 4. **If no brand specified, use the default aesthetic**

Content-Type Override Rules

**CRITICAL:** Some content types intentionally use different aesthetics than their host site.

| Content Type | Detection Pattern | Aesthetic to Use | DO NOT Use | |--------------|------------------|------------------|------------| | **Satirical/Parody Content** | User explicitly says "satire", "parody", "joke product" | Match the satire target's aesthetic (e.g., corporate B2B for business parody) | Host site's aesthetic | | **Easter Eggs** | Path contains `easter-eggs/`, explicitly marked as easter egg | Depends on easter egg theme, ask user if unclear | Host site's default |

**Rule:** When content-type override detected, DO NOT check host site style guides. The content is intentionally divergent.

Base Prompt Prefix Standard (MANDATORY)

**Every aesthetic MUST define a Base Prompt Prefix** — a locked consistency block that gets prepended to every image generation prompt for that aesthetic. This ensures visual cohesion across a set of illustrations.

**What the prefix locks down:**

• Line weight and quality
• Background treatment
• Camera angle / perspective
• Fill ratio (illustration vs. whitespace)
• Color balance percentages
• Shadow intensity and direction
• Text treatment (if applicable)

**Where to find each prefix:**

• Each aesthetic file (`.md`) contains a "Base Prompt Prefix" section with the locked values
• Project-specific aesthetics (e.g., lead magnet `AESTHETIC.md`) inherit from their parent brand and override only what changes
• **Always read the aesthetic file and use its prefix before generating** — never freestyle prompt parameters that have been locked

**When creating new aesthetics via `aesthetic-definer`:** The agent MUST produce a base prompt prefix as part of the output. An aesthetic without a consistency lock is incomplete.

Available Aesthetics

| Brand | Aesthetic File | Style | |-------|---------------|-------| | **Default** | `~/.claude/skills/art/aesthetic.md` | Hand-drawn sketch, cream backgrounds, teal/orange accents |

**To add a new aesthetic:** Create a new file at `~/.claude/skills/art/aesthetics/[name].md` using the default aesthetic as a template. See `aesthetics/README.md` for the required format.

Aesthetic Loading Rule

**Read the matching aesthetic file BEFORE writing any prompt or generating any image.** The aesthetic file is the source of truth for that brand's colors, style parameters, anti-patterns, and prompt integration phrases.

---

Workflow Routing

| Content Type | Workflow | |--------------|----------| | Blog headers / Editorial | `workflows/workflow.md` | | Adaptive orchestrator | `workflows/visualize.md` | | Flowcharts / Sequences | `workflows/mermaid.md` | | Architecture diagrams | `workflows/technical-diagrams.md` | | Classification grids | `workflows/taxonomies.md` | | Chronological | `workflows/timelines.md` | | 2x2 matrices | `workflows/frameworks.md` | | X vs Y | `workflows/comparisons.md` | | Screenshot markup | `workflows/annotated-screenshots.md` | | Step-by-step | `workflows/recipe-cards.md` | | Sketchnotes / visual notes | `workflows/sketchnotes.md` | | Quote cards | `workflows/aphorisms.md` | | Idea territories | `workflows/maps.md` | | Big numbers | `workflows/stats.md` | | Sequential panels | `workflows/comics.md` | | **Edit existing image** | `workflows/image-editing.md` |

---

Image Generation

**Default model:** nano-banana-2 (Gemini 3.1 Flash Image)

bun run ~/.claude/skills/art/tools/generate-image.ts \
  --model nano-banana-2 \
  --prompt "[PROMPT]" \
  --size 2K \
  --aspect-ratio 1:1 \
  --output /path/