Graphic Design Skill
Patterns for visual design, SVG creation, layout composition, typography, and brand identity.
Design Principles
Visual Hierarchy
| Level |
Purpose |
Techniques |
| Primary |
First thing seen |
Largest, boldest, highest contrast |
| Secondary |
Supporting info |
Medium size, moderate weight |
| Tertiary |
Details |
Smaller, lighter, subtle |
Hierarchy Tools
- Size — Larger = more important
- Weight — Bolder = more attention
- Color — High contrast = focal point
- Position — Top/center = primary
- Whitespace — Isolation = emphasis
Balance Types
| Type |
Characteristics |
Best For |
| Symmetrical |
Mirror image, formal |
Corporate, traditional |
| Asymmetrical |
Visual weight balanced, dynamic |
Modern, creative |
| Radial |
Elements radiate from center |
Logos, icons |
Layout & Composition
Grid Systems
┌─────┬─────┬─────┬─────┐
│ 1 │ 2 │ 3 │ 4 │ 12-column grid
├─────┼─────┼─────┼─────┤ (most flexible)
│ 5 │ 6 │ 7 │ 8 │
├─────┼─────┼─────┼─────┤
│ 9 │ 10 │ 11 │ 12 │
└─────┴─────┴─────┴─────┘
Golden Ratio (1:1.618)
- Use for proportions that feel "right"
- Width to height relationships
- Spacing progressions
- Element sizing
Rule of Thirds
┌─────────┬─────────┬─────────┐
│ │ ● │ │ Place key elements
├─────────┼─────────┼─────────┤ at intersection
│ ● │ │ ● │ points for dynamic
├─────────┼─────────┼─────────┤ composition
│ │ ● │ │
└─────────┴─────────┴─────────┘
Alignment Principles
| Principle |
Rule |
| Edge alignment |
Elements share common edges |
| Center alignment |
Elements share center axis |
| Baseline alignment |
Text shares baseline |
| Optical alignment |
Visually aligned (may differ from mathematical) |
Typography
Type Scale (1.25 ratio)
| Level |
Size |
Use |
| Display |
72px |
Hero headlines |
| H1 |
48px |
Page titles |
| H2 |
36px |
Section headers |
| H3 |
28px |
Subsections |
| Body |
16px |
Main content |
| Caption |
12px |
Supporting text |
Font Pairing Rules
| Combination |
Example |
Vibe |
| Serif + Sans |
Georgia + Helvetica |
Classic, professional |
| Sans + Sans |
Montserrat + Open Sans |
Modern, clean |
| Display + Body |
Playfair + Source Sans |
Elegant, editorial |
Typography Best Practices
- Line height: 1.4–1.6× font size for body
- Line length: 45–75 characters optimal
- Letter spacing: Increase for ALL CAPS
- Contrast: Dark on light or light on dark
- Hierarchy: Max 3 font sizes per design
Color Theory
Color Relationships
Primary
●
/|\
/ | \
/ | \
●───●───●
Secondary Tertiary
Color Schemes
| Scheme |
Description |
Mood |
| Monochromatic |
One hue, varied lightness |
Cohesive, elegant |
| Complementary |
Opposite on wheel |
High contrast, vibrant |
| Analogous |
Adjacent on wheel |
Harmonious, natural |
| Triadic |
Three equidistant |
Balanced, dynamic |
| Split-complementary |
Base + two adjacent to complement |
Softer contrast |
Color Psychology
| Color |
Associations |
Use Cases |
| Blue |
Trust, stability, tech |
Corporate, software |
| Green |
Growth, nature, success |
Health, finance |
| Red |
Energy, urgency, passion |
CTAs, alerts |
| Purple |
Creativity, luxury |
Premium, creative |
| Orange |
Friendly, energetic |
Social, youth |
| Yellow |
Optimism, attention |
Highlights, warnings |
Contrast & Accessibility
| WCAG Level |
Contrast Ratio |
Use |
| AA (normal) |
4.5:1 |
Body text |
| AA (large) |
3:1 |
18px+ or 14px bold |
| AAA |
7:1 |
Maximum accessibility |
Applying Color Theory to Mermaid Diagrams
Color theory principles translate directly to Mermaid diagram styling. The GitHub Pastel Palette v2 (defined in the markdown-mermaid skill) implements these principles:
Semantic Color Mapping (from color psychology):
| Semantic Purpose |
Palette Color |
Fill |
Text |
Stroke |
| Primary actions |
Blue |
#ddf4ff |
#0550ae |
#80ccff |
| Success/output |
Green |
#d3f5db |
#1a7f37 |
#6fdd8b |
| Business logic |
Gold |
#fff8c5 |
#9a6700 |
#d4a72c |
| Special/DevOps |
Purple |
#d8b9ff |
#6639ba |
#bf8aff |
| Errors/critical |
Red |
#ffebe9 |
#cf222e |
#f5a3a3 |
| Raw/ingestion |
Bronze |
#fff1e5 |
#953800 |
#ffb77c |
| Background |
Neutral |
#eaeef2 |
#24292f |
#d0d7de |
Design Principles Applied:
- Triadic harmony: Blue + Gold + Red form a balanced triad
- Analogous groups: Green + Blue are adjacent, creating calm flow sections
- Light fills + dark text: Ensures WCAG AA contrast (4.5:1+)
- Neutral arrows (
#57606a): Don't compete with colored nodes — visual hierarchy preserved
- Consistent stroke family: Each color has a matching mid-tone stroke (not jarring black borders)
When to Override the Palette:
- Diagrams comparing two systems → Use just 2 contrasting colors (complementary scheme)
- Status dashboards → Green/Yellow/Red RAG mapping
- Sequential processes → Monochromatic gradient (light to dark within one hue)
SVG Design
SVG Structure
<svg viewBox="0 0 width height" xmlns="...">
<defs>
<!-- Reusable definitions -->
<linearGradient id="grad1">...</linearGradient>
<filter id="shadow">...</filter>
</defs>
<!-- Background layer -->
<rect .../>
<!-- Main content -->
<g transform="translate(x, y)">
<!-- Grouped elements -->
</g>
<!-- Foreground/overlay -->
</svg>
Common SVG Elements
| Element |
Use |
Key Attributes |
<rect> |
Rectangles, backgrounds |
x, y, width, height, rx (rounded) |
<circle> |
Circles, dots |
cx, cy, r |
<ellipse> |
Ovals |
cx, cy, rx, ry |
<line> |
Straight lines |
x1, y1, x2, y2 |
<path> |
Complex shapes |
d (path data) |
<text> |
Typography |
x, y, text-anchor, dominant-baseline |
<g> |
Grouping |
transform |
SVG Path Commands
| Command |
Meaning |
Example |
| M |
Move to |
M 10 20 |
| L |
Line to |
L 30 40 |
| H |
Horizontal line |
H 50 |
| V |
Vertical line |
V 60 |
| Q |
Quadratic curve |
Q cx cy, x y |
| C |
Cubic curve |
C cx1 cy1, cx2 cy2, x y |
| Z |
Close path |
Z |
SVG Text Alignment
<!-- Horizontal alignment -->
text-anchor="start|middle|end"
<!-- Vertical alignment -->
dominant-baseline="auto|middle|central|hanging"
<!-- Centered text -->
<text x="50%" y="50%" text-anchor="middle" dominant-baseline="central">
Perfectly Centered
</text>
SVG Gradients
<!-- Linear gradient -->
<linearGradient id="grad" x1="0%" y1="0%" x2="100%" y2="0%">
<stop offset="0%" stop-color="#007ACC"/>
<stop offset="100%" stop-color="#00a8e8"/>
</linearGradient>
<!-- Radial gradient -->
<radialGradient id="glow" cx="50%" cy="50%" r="50%">
<stop offset="0%" stop-color="#007ACC" stop-opacity="0.4"/>
<stop offset="100%" stop-color="#007ACC" stop-opacity="0"/>
</radialGradient>
SVG Transforms
| Transform |
Syntax |
Use |
| Translate |
translate(x, y) |
Move element |
| Rotate |
rotate(deg, cx, cy) |
Spin around point |
| Scale |
scale(x, y) |
Resize |
| Skew |
skewX(deg) / skewY(deg) |
Shear |
Banner & Marketing Design
Banner Dimensions
| Platform |
Size |
Aspect |
| VS Code Marketplace |
1280×640 |
2:1 |
| GitHub Social |
1280×640 |
2:1 |
| Twitter Header |
1500×500 |
3:1 |
| LinkedIn Banner |
1584×396 |
4:1 |
| Open Graph |
1200×630 |
~1.9:1 |
Banner Composition
┌─────────────────────────────────────────┐
│ ┌─────────────────────────────────┐ │
│ │ VISUAL ELEMENT │ │ Top third: Logo/Icon
│ └─────────────────────────────────┘ │
│ │
│ MAIN HEADLINE │ Middle: Primary message
│ Subtitle Text │
│ │
│ [Badge 1] [Badge 2] [Badge 3] │ Bottom third: CTAs/Details
└─────────────────────────────────────────┘
Badge/Pill Design
<!-- Rounded pill badge -->
<g>
<rect x="-50" y="-16" width="100" height="32" rx="16"
fill="#007ACC" opacity="0.15"/>
<text x="0" y="0" text-anchor="middle" dominant-baseline="central"
font-size="12" fill="#94a3b8">Label</text>
</g>
Icon Design
Icon Grid
┌────────────────────┐
│ ┌──────────────┐ │ Outer: Padding zone
│ │ │ │ Inner: Safe area
│ │ CONTENT │ │ Content: Icon artwork
│ │ │ │
│ └──────────────┘ │ Standard: 24×24, 16×16
└────────────────────┘
Icon Principles
- Simplicity — Recognize at small sizes
- Consistency — Same stroke weight, style
- Optical balance — Visually centered, not mathematically
- Metaphor — Universally understood symbols
Icon Styles
| Style |
Characteristics |
Use |
| Outlined |
Stroke only, no fill |
Light, modern UI |
| Filled |
Solid shapes |
Bold, clear visibility |
| Duotone |
Two tones/colors |
Distinctive, branded |
| Glyph |
Single color, simplified |
System icons |
Design Systems
Spacing Scale (8px base)
| Token |
Value |
Use |
| xs |
4px |
Tight spacing |
| sm |
8px |
Default gap |
| md |
16px |
Section spacing |
| lg |
24px |
Component gaps |
| xl |
32px |
Major sections |
| 2xl |
48px |
Hero spacing |
Elevation/Shadow
| Level |
Shadow |
Use |
| 0 |
None |
Flat elements |
| 1 |
0 1px 2px |
Subtle lift |
| 2 |
0 2px 4px |
Cards |
| 3 |
0 4px 8px |
Dropdowns |
| 4 |
0 8px 16px |
Modals |
Border Radius Scale
| Token |
Value |
Use |
| none |
0 |
Sharp corners |
| sm |
4px |
Subtle rounding |
| md |
8px |
Standard buttons |
| lg |
16px |
Cards, pills |
| full |
9999px |
Circles, pills |
Illustration Principles
Universal principles for placing illustrations in any document — READMEs, docs, presentations, books.
Principle 1: Contextual Placement
An image should answer: "Why HERE?"
Place images at the exact moment they illustrate. An image that appears next to the content it depicts reinforces understanding; a decorative image placed arbitrarily adds noise.
Principle 2: Visual Variety
Readers should be surprised by each image, not numb to them.
Avoid repeating the same visual formula. Vary: composition, subject matter, perspective, color palette, and image type (diagram, screenshot, illustration, photo).
Principle 3: Narrative Function
Every illustration should serve one of these purposes:
| Function |
Description |
Example |
| Anchor |
Mark a pivotal moment or concept |
Architecture diagram at design section |
| Reveal |
Show something text describes |
Screenshot of the UI being discussed |
| Transition |
Signal a tonal or topic shift |
Banner between major sections |
| Character |
Deepen connection to a person/persona |
Avatar at persona introduction |
| Setting |
Establish context or environment |
Deployment diagram for infrastructure |
| Evidence |
Visual proof or data |
Chart, graph, or test results |
Principle 4: Format Consistency
HTML for precise control:
<p align="center">
<img src="assets/IMAGE.png" alt="Descriptive alt text" width="60%">
</p>
Width guidelines:
| Asset Type |
Width |
Use |
| Full-width banners |
100% |
Section headers, hero images |
| Feature illustrations |
60% |
In-content diagrams, screenshots |
| Spot illustrations |
40-50% |
Inline accents, small diagrams |
| Icons/badges |
20-30% |
Status indicators, inline elements |
Design Review Checklist
Visual Quality
Typography
Color
Technical
Synapses
High-Strength Connections
- [creative-writing] (High, Complements, Bidirectional) — "Visual storytelling"
- [vscode-extension-patterns] (High, Applies, Forward) — "Extension branding and UI"
Medium-Strength Connections
- [markdown-mermaid] (Medium, Extends, Bidirectional) — "Diagram visualization"
- [cognitive-load] (Medium, Applies, Forward) — "Visual information processing"
- [ascii-art-alignment] (Medium, Complements, Bidirectional) — "Text-based visual design"
Supporting Connections
- [academic-research] (Low, Supports, Forward) — "Document visual design"
- [meditation] (Low, Uses, Forward) — "Reflective design iteration"
1---2name: graphic-design-skill3description: Patterns for visual design, SVG creation, layout composition, typography, and brand identity.4---56# Graphic Design Skill78> Patterns for visual design, SVG creation, layout composition, typography, and brand identity.910## Design Principles1112### Visual Hierarchy1314| Level | Purpose | Techniques |15| ----- | ------- | ---------- |16| **Primary** | First thing seen | Largest, boldest, highest contrast |17| **Secondary** | Supporting info | Medium size, moderate weight |18| **Tertiary** | Details | Smaller, lighter, subtle |1920### Hierarchy Tools2122- **Size** — Larger = more important23- **Weight** — Bolder = more attention24- **Color** — High contrast = focal point25- **Position** — Top/center = primary26- **Whitespace** — Isolation = emphasis2728### Balance Types2930| Type | Characteristics | Best For |31| ---- | --------------- | -------- |32| **Symmetrical** | Mirror image, formal | Corporate, traditional |33| **Asymmetrical** | Visual weight balanced, dynamic | Modern, creative |34| **Radial** | Elements radiate from center | Logos, icons |3536## Layout & Composition3738### Grid Systems3940```text41┌─────┬─────┬─────┬─────┐42│ 1 │ 2 │ 3 │ 4 │ 12-column grid43├─────┼─────┼─────┼─────┤ (most flexible)44│ 5 │ 6 │ 7 │ 8 │45├─────┼─────┼─────┼─────┤46│ 9 │ 10 │ 11 │ 12 │47└─────┴─────┴─────┴─────┘48```4950### Golden Ratio (1:1.618)5152- Use for proportions that feel "right"53- Width to height relationships54- Spacing progressions55- Element sizing5657### Rule of Thirds5859```text60┌─────────┬─────────┬─────────┐61│ │ ● │ │ Place key elements62├─────────┼─────────┼─────────┤ at intersection63│ ● │ │ ● │ points for dynamic64├─────────┼─────────┼─────────┤ composition65│ │ ● │ │66└─────────┴─────────┴─────────┘67```6869### Alignment Principles7071| Principle | Rule |72| --------- | ---- |73| **Edge alignment** | Elements share common edges |74| **Center alignment** | Elements share center axis |75| **Baseline alignment** | Text shares baseline |76| **Optical alignment** | Visually aligned (may differ from mathematical) |7778## Typography7980### Type Scale (1.25 ratio)8182| Level | Size | Use |83| ----- | ---- | --- |84| Display | 72px | Hero headlines |85| H1 | 48px | Page titles |86| H2 | 36px | Section headers |87| H3 | 28px | Subsections |88| Body | 16px | Main content |89| Caption | 12px | Supporting text |9091### Font Pairing Rules9293| Combination | Example | Vibe |94| ----------- | ------- | ---- |95| Serif + Sans | Georgia + Helvetica | Classic, professional |96| Sans + Sans | Montserrat + Open Sans | Modern, clean |97| Display + Body | Playfair + Source Sans | Elegant, editorial |9899### Typography Best Practices100101- **Line height**: 1.4–1.6× font size for body102- **Line length**: 45–75 characters optimal103- **Letter spacing**: Increase for ALL CAPS104- **Contrast**: Dark on light or light on dark105- **Hierarchy**: Max 3 font sizes per design106107## Color Theory108109### Color Relationships110111```text112 Primary113 ●114 /|\115 / | \116 / | \117 ●───●───●118 Secondary Tertiary119```120121### Color Schemes122123| Scheme | Description | Mood |124| ------ | ----------- | ---- |125| **Monochromatic** | One hue, varied lightness | Cohesive, elegant |126| **Complementary** | Opposite on wheel | High contrast, vibrant |127| **Analogous** | Adjacent on wheel | Harmonious, natural |128| **Triadic** | Three equidistant | Balanced, dynamic |129| **Split-complementary** | Base + two adjacent to complement | Softer contrast |130131### Color Psychology132133| Color | Associations | Use Cases |134| ----- | ------------ | --------- |135| **Blue** | Trust, stability, tech | Corporate, software |136| **Green** | Growth, nature, success | Health, finance |137| **Red** | Energy, urgency, passion | CTAs, alerts |138| **Purple** | Creativity, luxury | Premium, creative |139| **Orange** | Friendly, energetic | Social, youth |140| **Yellow** | Optimism, attention | Highlights, warnings |141142### Contrast & Accessibility143144| WCAG Level | Contrast Ratio | Use |145| ---------- | -------------- | --- |146| AA (normal) | 4.5:1 | Body text |147| AA (large) | 3:1 | 18px+ or 14px bold |148| AAA | 7:1 | Maximum accessibility |149150### Applying Color Theory to Mermaid Diagrams151152Color theory principles translate directly to Mermaid diagram styling. The **GitHub Pastel Palette v2** (defined in the **markdown-mermaid** skill) implements these principles:153154**Semantic Color Mapping** (from color psychology):155156| Semantic Purpose | Palette Color | Fill | Text | Stroke |157| ---------------- | ------------- | ---- | ---- | ------ |158| Primary actions | Blue | `#ddf4ff` | `#0550ae` | `#80ccff` |159| Success/output | Green | `#d3f5db` | `#1a7f37` | `#6fdd8b` |160| Business logic | Gold | `#fff8c5` | `#9a6700` | `#d4a72c` |161| Special/DevOps | Purple | `#d8b9ff` | `#6639ba` | `#bf8aff` |162| Errors/critical | Red | `#ffebe9` | `#cf222e` | `#f5a3a3` |163| Raw/ingestion | Bronze | `#fff1e5` | `#953800` | `#ffb77c` |164| Background | Neutral | `#eaeef2` | `#24292f` | `#d0d7de` |165166**Design Principles Applied**:1671681. **Triadic harmony**: Blue + Gold + Red form a balanced triad1692. **Analogous groups**: Green + Blue are adjacent, creating calm flow sections1703. **Light fills + dark text**: Ensures WCAG AA contrast (4.5:1+)1714. **Neutral arrows** (`#57606a`): Don't compete with colored nodes — visual hierarchy preserved1725. **Consistent stroke family**: Each color has a matching mid-tone stroke (not jarring black borders)173174**When to Override the Palette**:175- Diagrams comparing two systems → Use just 2 contrasting colors (complementary scheme)176- Status dashboards → Green/Yellow/Red RAG mapping177- Sequential processes → Monochromatic gradient (light to dark within one hue)178179## SVG Design180181### SVG Structure182183```xml184<svg viewBox="0 0 width height" xmlns="...">185 <defs>186 <!-- Reusable definitions -->187 <linearGradient id="grad1">...</linearGradient>188 <filter id="shadow">...</filter>189 </defs>190191 <!-- Background layer -->192 <rect .../>193194 <!-- Main content -->195 <g transform="translate(x, y)">196 <!-- Grouped elements -->197 </g>198199 <!-- Foreground/overlay -->200</svg>201```202203### Common SVG Elements204205| Element | Use | Key Attributes |206| ------- | --- | -------------- |207| `<rect>` | Rectangles, backgrounds | x, y, width, height, rx (rounded) |208| `<circle>` | Circles, dots | cx, cy, r |209| `<ellipse>` | Ovals | cx, cy, rx, ry |210| `<line>` | Straight lines | x1, y1, x2, y2 |211| `<path>` | Complex shapes | d (path data) |212| `<text>` | Typography | x, y, text-anchor, dominant-baseline |213| `<g>` | Grouping | transform |214215### SVG Path Commands216217| Command | Meaning | Example |218| ------- | ------- | ------- |219| M | Move to | M 10 20 |220| L | Line to | L 30 40 |221| H | Horizontal line | H 50 |222| V | Vertical line | V 60 |223| Q | Quadratic curve | Q cx cy, x y |224| C | Cubic curve | C cx1 cy1, cx2 cy2, x y |225| Z | Close path | Z |226227### SVG Text Alignment228229```xml230<!-- Horizontal alignment -->231text-anchor="start|middle|end"232233<!-- Vertical alignment -->234dominant-baseline="auto|middle|central|hanging"235236<!-- Centered text -->237<text x="50%" y="50%" text-anchor="middle" dominant-baseline="central">238 Perfectly Centered239</text>240```241242### SVG Gradients243244```xml245<!-- Linear gradient -->246<linearGradient id="grad" x1="0%" y1="0%" x2="100%" y2="0%">247 <stop offset="0%" stop-color="#007ACC"/>248 <stop offset="100%" stop-color="#00a8e8"/>249</linearGradient>250251<!-- Radial gradient -->252<radialGradient id="glow" cx="50%" cy="50%" r="50%">253 <stop offset="0%" stop-color="#007ACC" stop-opacity="0.4"/>254 <stop offset="100%" stop-color="#007ACC" stop-opacity="0"/>255</radialGradient>256```257258### SVG Transforms259260| Transform | Syntax | Use |261| --------- | ------ | --- |262| Translate | translate(x, y) | Move element |263| Rotate | rotate(deg, cx, cy) | Spin around point |264| Scale | scale(x, y) | Resize |265| Skew | skewX(deg) / skewY(deg) | Shear |266267## Banner & Marketing Design268269### Banner Dimensions270271| Platform | Size | Aspect |272| -------- | ---- | ------ |273| VS Code Marketplace | 1280×640 | 2:1 |274| GitHub Social | 1280×640 | 2:1 |275| Twitter Header | 1500×500 | 3:1 |276| LinkedIn Banner | 1584×396 | 4:1 |277| Open Graph | 1200×630 | ~1.9:1 |278279### Banner Composition280281```text282┌─────────────────────────────────────────┐283│ ┌─────────────────────────────────┐ │284│ │ VISUAL ELEMENT │ │ Top third: Logo/Icon285│ └─────────────────────────────────┘ │286│ │287│ MAIN HEADLINE │ Middle: Primary message288│ Subtitle Text │289│ │290│ [Badge 1] [Badge 2] [Badge 3] │ Bottom third: CTAs/Details291└─────────────────────────────────────────┘292```293294### Badge/Pill Design295296```xml297<!-- Rounded pill badge -->298<g>299 <rect x="-50" y="-16" width="100" height="32" rx="16"300 fill="#007ACC" opacity="0.15"/>301 <text x="0" y="0" text-anchor="middle" dominant-baseline="central"302 font-size="12" fill="#94a3b8">Label</text>303</g>304```305306## Icon Design307308### Icon Grid309310```text311┌────────────────────┐312│ ┌──────────────┐ │ Outer: Padding zone313│ │ │ │ Inner: Safe area314│ │ CONTENT │ │ Content: Icon artwork315│ │ │ │316│ └──────────────┘ │ Standard: 24×24, 16×16317└────────────────────┘318```319320### Icon Principles321322- **Simplicity** — Recognize at small sizes323- **Consistency** — Same stroke weight, style324- **Optical balance** — Visually centered, not mathematically325- **Metaphor** — Universally understood symbols326327### Icon Styles328329| Style | Characteristics | Use |330| ----- | --------------- | --- |331| **Outlined** | Stroke only, no fill | Light, modern UI |332| **Filled** | Solid shapes | Bold, clear visibility |333| **Duotone** | Two tones/colors | Distinctive, branded |334| **Glyph** | Single color, simplified | System icons |335336## Design Systems337338### Spacing Scale (8px base)339340| Token | Value | Use |341| ----- | ----- | --- |342| xs | 4px | Tight spacing |343| sm | 8px | Default gap |344| md | 16px | Section spacing |345| lg | 24px | Component gaps |346| xl | 32px | Major sections |347| 2xl | 48px | Hero spacing |348349### Elevation/Shadow350351| Level | Shadow | Use |352| ----- | ------ | --- |353| 0 | None | Flat elements |354| 1 | 0 1px 2px | Subtle lift |355| 2 | 0 2px 4px | Cards |356| 3 | 0 4px 8px | Dropdowns |357| 4 | 0 8px 16px | Modals |358359### Border Radius Scale360361| Token | Value | Use |362| ----- | ----- | --- |363| none | 0 | Sharp corners |364| sm | 4px | Subtle rounding |365| md | 8px | Standard buttons |366| lg | 16px | Cards, pills |367| full | 9999px | Circles, pills |368369## Illustration Principles370371Universal principles for placing illustrations in any document — READMEs, docs, presentations, books.372373### Principle 1: Contextual Placement374375> **An image should answer: "Why HERE?"**376377Place images at the exact moment they illustrate. An image that appears next to the content it depicts reinforces understanding; a decorative image placed arbitrarily adds noise.378379### Principle 2: Visual Variety380381> **Readers should be surprised by each image, not numb to them.**382383Avoid repeating the same visual formula. Vary: composition, subject matter, perspective, color palette, and image type (diagram, screenshot, illustration, photo).384385### Principle 3: Narrative Function386387Every illustration should serve one of these purposes:388389| Function | Description | Example |390|----------|-------------|--------|391| **Anchor** | Mark a pivotal moment or concept | Architecture diagram at design section |392| **Reveal** | Show something text describes | Screenshot of the UI being discussed |393| **Transition** | Signal a tonal or topic shift | Banner between major sections |394| **Character** | Deepen connection to a person/persona | Avatar at persona introduction |395| **Setting** | Establish context or environment | Deployment diagram for infrastructure |396| **Evidence** | Visual proof or data | Chart, graph, or test results |397398### Principle 4: Format Consistency399400**HTML for precise control:**401```html402<p align="center">403<img src="assets/IMAGE.png" alt="Descriptive alt text" width="60%">404</p>405```406407**Width guidelines:**408409| Asset Type | Width | Use |410|------------|-------|-----|411| Full-width banners | 100% | Section headers, hero images |412| Feature illustrations | 60% | In-content diagrams, screenshots |413| Spot illustrations | 40-50% | Inline accents, small diagrams |414| Icons/badges | 20-30% | Status indicators, inline elements |415416---417418## Design Review Checklist419420### Visual Quality421422- [ ] Consistent spacing throughout423- [ ] Aligned elements (check edges)424- [ ] Balanced composition425- [ ] Clear visual hierarchy426- [ ] Appropriate whitespace427428### Typography429430- [ ] Readable font sizes431- [ ] Proper line height432- [ ] Consistent font usage433- [ ] Good contrast ratios434- [ ] Appropriate letter spacing435436### Color437438- [ ] Consistent color palette439- [ ] Sufficient contrast440- [ ] Meaningful color use441- [ ] Works in different contexts442- [ ] Accessible (WCAG compliant)443444### Technical445446- [ ] Optimized file size447- [ ] Correct dimensions448- [ ] Responsive/scalable449- [ ] Cross-platform compatible450- [ ] Proper naming conventions451452## Synapses453454### High-Strength Connections455456- [creative-writing] (High, Complements, Bidirectional) — "Visual storytelling"457- [vscode-extension-patterns] (High, Applies, Forward) — "Extension branding and UI"458459### Medium-Strength Connections460461- [markdown-mermaid] (Medium, Extends, Bidirectional) — "Diagram visualization"462- [cognitive-load] (Medium, Applies, Forward) — "Visual information processing"463- [ascii-art-alignment] (Medium, Complements, Bidirectional) — "Text-based visual design"464465### Supporting Connections466467- [academic-research] (Low, Supports, Forward) — "Document visual design"468- [meditation] (Low, Uses, Forward) — "Reflective design iteration"