recipe-refine-visuals

Installation
SKILL.md

Context: Refine the Visual Tokens in docs/product/design/brand-direction.md after recipe-blueprint has created an initial set.

This is intentionally a side workflow. Use it when a human with design judgment wants to refine the auto-derived token set. Do not force this into the main blueprint flow for users who cannot make token-level design decisions.

Required Skills [LOAD BEFORE EXECUTION]

  1. [LOAD IF NOT ACTIVE] blueprint-standards — brand-direction template and Visual Token structure
  2. [LOAD IF NOT ACTIVE] design-perspective — accessibility and persona-aware design review

Workflow

  1. Read docs/product/design/brand-direction.md
  2. Review current Visual Tokens against design principles, personas, and prototype learnings
  3. Verify:
    • text-on-surface contrast ratio is at least 4.5:1 for normal text
    • heading text is at least 1.25x the body size in the primary hierarchy step
    • spacing tokens form a consistent increasing scale without reversals
  4. Present overrides and rationale to the user
  5. After approval, update the same brand-direction.md file and mark the source as expert-refined
Installs
1
Repository
shinpr/nautilus
GitHub Stars
3
First Seen
Jul 22, 2026
recipe-refine-visuals — shinpr/nautilus