colorize

name	colorize
description	Add strategic color to features that are too monochromatic or lack visual interest, making interfaces more engaging and expressive. Use when the user mentions the design looking gray, dull, lacking warmth, needing more color, or wanting a more vibrant or expressive palette.
argument-hint	[target]
user-invocable	true

Strategically introduce color to designs that are too monochromatic, gray, or lacking in visual warmth and personality.

MANDATORY PREPARATION

Run the cognition constraint loop (MANDATORY) — see ~/.claude/docs/reference/cognition-constraint-loop.md. (If design-builder loaded this skill only for craft reference, ignore this block and use the craft below.)

Invoke {{command_prefix}}impeccable — it contains design principles, anti-patterns, and the Context Gathering Protocol. Follow the protocol before proceeding — if no design context exists yet, you MUST run {{command_prefix}}impeccable teach first. Additionally gather: existing brand colors.

---

Tailwind palette refused (NEW)

Utility classes like bg-blue-500 and direct hex matches on Tailwind 500-shade values are refused. Reach for material-derived substitutes:

• Instead of tech-orange → brass / gold (OKLCH ~L 0.75 C 0.12 H 80)
• Instead of tech-blue → [direction only — consult user; blue is the hue Adil judges reliably per his colorblindness]
• Instead of Tailwind grays → sand / eggshell (warm desaturated neutrals)

See ~/.claude/docs/concepts/design-contract/rants/colors.md for the full refusal + blue-deferred policy.

---

Assess Color Opportunity

Analyze the current state and identify opportunities:

1. Understand current state:

   • Color absence: Pure grayscale? Limited neutrals? One timid accent?
   • Missed opportunities: Where could color add meaning, hierarchy, or delight?
   • Context: What's appropriate for this domain and audience?
   • Brand: Are there existing brand colors we should use?

2. Identify where color adds value:

   • Semantic meaning: Success (green), error (red), warning (yellow/orange), info (blue)
   • Hierarchy: Drawing attention to important elements
   • Categorization: Different sections, types, or states
   • Emotional tone: Warmth, energy, trust, creativity
   • Wayfinding: Helping users navigate and understand structure
   • Delight: Moments of visual interest and personality

If any of these are unclear from the codebase, {{ask_instruction}}

CRITICAL: More color ≠ better. Strategic color beats rainbow vomit every time. Every color should have a purpose.

Plan Color Strategy

Create a purposeful color introduction plan:

• Color palette: What colors match the brand/context? (Choose 2-4 colors max beyond neutrals)
• Dominant color: Which color owns 60% of colored elements?
• Accent colors: Which colors provide contrast and highlights? (30% and 10%)
• Application strategy: Where does each color appear and why?

IMPORTANT: Color should enhance hierarchy and meaning, not create chaos. Less is more when it matters more.

Introduce Color Strategically

Add color systematically across these dimensions:

Semantic Color

• State indicators:

  • Success: Green tones (emerald, forest, mint)
  • Error: Red/pink tones (rose, crimson, coral)
  • Warning: Orange/amber tones
  • Info: Blue tones (sky, ocean, indigo)
  • Neutral: Gray/slate for inactive states

• Status badges: Colored backgrounds or borders for states (active, pending, completed, etc.)

• Progress indicators: Colored bars, rings, or charts showing completion or health

Accent Color Application

• Primary actions: Color the most important buttons/CTAs
• Links: Add color to clickable text (maintain accessibility)
• Icons: Colorize key icons for recognition and personality
• Headers/titles: Add color to section headers or key labels
• Hover states: Introduce color on interaction

Background & Surfaces

• Tinted backgrounds: Replace pure gray (#f5f5f5) with warm neutrals (oklch(97% 0.01 60)) or cool tints (oklch(97% 0.01 250))
• Colored sections: Use subtle background colors to separate areas
• Gradient backgrounds: Add depth with subtle, intentional gradients (not generic purple-blue)
• Cards & surfaces: Tint cards or surfaces slightly for warmth

Use OKLCH for color: It's perceptually uniform, meaning equal steps in lightness look equal. Great for generating harmonious scales.

Data Visualization

• Charts & graphs: Use color to encode categories or values
• Heatmaps: Color intensity shows density or importance
• Comparison: Color coding for different datasets or timeframes

Borders & Accents

• Accent borders: Add colored left/top borders to cards or sections
• Underlines: Color underlines for emphasis or active states
• Dividers: Subtle colored dividers instead of gray lines
• Focus rings: Colored focus indicators matching brand

Typography Color

• Colored headings: Use brand colors for section headings (maintain contrast)
• Highlight text: Color for emphasis or categories
• Labels & tags: Small colored labels for metadata or categories

Decorative Elements

• Illustrations: Add colored illustrations or icons
• Shapes: Geometric shapes in brand colors as background elements
• Gradients: Colorful gradient overlays or mesh backgrounds
• Blobs/organic shapes: Soft colored shapes for visual interest

Balance & Refinement

Ensure color addition improves rather than overwhelms:

Maintain Hierarchy

• Dominant color (60%): Primary brand color or most used accent
• Secondary color (30%): Supporting color for variety
• Accent color (10%): High contrast for key moments
• Neutrals (remaining): Gray/black/white for structure

Accessibility

• Contrast ratios: Ensure WCAG compliance (4.5:1 for text, 3:1 for UI components)
• Don't rely on color alone: Use icons, labels, or patterns alongside color
• Test for color blindness: Verify red/green combinations work for all users

Cohesion

• Consistent palette: Use colors from defined palette, not arbitrary choices
• Systematic application: Same color meanings throughout (green always = success)
• Temperature consistency: Warm palette stays warm, cool stays cool

NEVER:

• Use every color in the rainbow (choose 2-4 colors beyond neutrals)
• Apply color randomly without semantic meaning
• Put gray text on colored backgrounds—it looks washed out; use a darker shade of the background color or transparency instead
• Use pure gray for neutrals—add subtle color tint (warm or cool) for sophistication
• Use pure black (#000) or pure white (#fff) for large areas
• Violate WCAG contrast requirements
• Use color as the only indicator (accessibility issue)
• Make everything colorful (defeats the purpose)
• Default to purple-blue gradients (AI slop aesthetic)

Verify Color Addition

Test that colorization improves the experience:

• Better hierarchy: Does color guide attention appropriately?
• Clearer meaning: Does color help users understand states/categories?
• More engaging: Does the interface feel warmer and more inviting?
• Still accessible: Do all color combinations meet WCAG standards?
• Not overwhelming: Is color balanced and purposeful?

Remember: Color is emotional and powerful. Use it to create warmth, guide attention, communicate meaning, and express personality. But restraint and strategy matter more than saturation and variety. Be colorful, but be intentional.

---

SwiftUI target

When the iOS architect passes platform: swiftui, the builder reads ONLY this section — the CSS craft above does NOT apply.

• Translate every OKLCH/hex instruction above into a named Color token: define the palette in the asset catalog (Color Set, sRGB, light + dark variants) and expose it via DesignSystem/Tokens/ColorTokens.swift. NO oklch(...)/hsl(...) strings, NO px, NO raw hex in views (raw-hex-outside-tokens P0).
• Semantic tokens, not literals: Color.success/.danger/.warning/.info resolve to token assets — a view never names a channel value.
• Blue carries the chroma on this project; distinguish categories by lightness tier, never by hue (hue-coded-category, off-palette-hue P0). The one non-blue chromatic is an icon-required danger red.
• Tint neutrals via token assets (never pure gray); NO gradient hero washes (gradient-fill P0), NO .tint(.blue)/.accentColor(.blue) default accent (ios-default-reflex P0).
• Self-check with swiftdesigncheck (NOT designcheck.js).

---

Rant-capture at handback

After completing the work, before returning to the user, ask:

"Returned to bench. Anything here you'd rant about?"

If the user responds, append the entry to the current project's .orca/design-rants-pending.md in this format:

## YYYY-MM-DD HH:MM — [verb-name]
[user's response verbatim]

Create .orca/ in the current project if absent. Do NOT write to ~/.claude/ or to the ORCA-OS source tree directly. Pending entries are swept and categorized later via /impeccable extract rants.