visual-designer

Visual Designer (optimize phase)

Make the article scannable and well-designed without changing what it says. This is a presentation pass. See agents/visual-designer.md for the role and hard constraints, and references/style/visual-design-components.md for the exact native-markdown pattern of every component. This SKILL is the playbook.

Step 0 — Read the situation

# density result (which components are missing / over-used), if the check already ran
cat memory/workspace/{task}/visual-density.json 2>/dev/null

Read draft.md and angle.json (format_id). The format decides which components fit.

Step 1 — Plan by format (substance first)

Format	Add (in priority order)
pillar	comparison table (Types/Choosing), ## By the Numbers, 1 quotation, ## Glossary (What-is-X), a checklist (Getting started)
comparison / review	up to 3 tables (quick / pricing / feature), 1 verdict quotation
how-to / buyers-guide	numbered framework, ≤2 > **Warning:** callouts on failure steps, 1 spec table
listicle / roundup	a spec table or ## By the Numbers per item cluster, ≤1 callout per top pick
weekly-digest	## At a Glance table, ## By the Numbers, callouts for opinion blocks
opinion	1 real quotation, minimal boxes

Only add what genuinely fits the content. Do NOT invent a comparison that is not in the text.

⛔ Stat-grid value contract (hard gate — scripts/lint/stat_grid_check.py, v3.39.0)

In a ## By the Numbers list the bold lead becomes a large DISPLAY FIGURE inside a narrow card. It must be a short number: ≤16 chars · longest word ≤10 chars · starts with a digit/$/~/± · does not end with :. All descriptive words go AFTER the closing **.

❌ - **30% more chlorophyll** in shaded tencha        →  ✅ - **30% more** chlorophyll in shaded tencha
❌ - **$12,000 to $25,000+ per month** retainer band  →  ✅ - **$12k-$25k/mo** enterprise retainer band
❌ - **Notched Izod verdict:** TPU absorbs 4x         →  ✅ - **4x** the notched Izod impact energy of PLA