SKILL.md
UX Advisor - Web Design Knowledge
Expert design guidance from 23 curated professional books covering color theory, typography, layout, UX/UI patterns, responsive design, and CSS techniques.
How to Query
Run the CLI script to search the knowledge base. The skill is installed at ~/.claude/skills/ux-advisor/.
# General design question
~/.claude/skills/ux-advisor/venv/bin/python ~/.claude/skills/ux-advisor/scripts/query_kb.py --query "YOUR QUESTION"
# Color advice
~/.claude/skills/ux-advisor/venv/bin/python ~/.claude/skills/ux-advisor/scripts/query_kb.py --query "CONTEXT" --type color --mood MOOD
# Layout patterns
~/.claude/skills/ux-advisor/venv/bin/python ~/.claude/skills/ux-advisor/scripts/query_kb.py --query "PAGE TYPE" --type layout --page-type TYPE
# UX best practices
~/.claude/skills/ux-advisor/venv/bin/python ~/.claude/skills/ux-advisor/scripts/query_kb.py --query "FEATURE" --type ux
Query Types
| Type | Use For | Key Options |
|---|---|---|
general |
Open design questions | --topics (comma-separated) |
color |
Color palettes, harmony | --mood (professional, playful, calm, etc.) |
layout |
Page structure, grids | --page-type (dashboard, landing_page, etc.) |
ux |
Usability, user flows | --user-context |
Routing Guide
Detect query type from user's question:
- Color: "color", "palette", "contrast", "hue", "scheme" →
--type color - Layout: "layout", "grid", "spacing", "structure", "responsive" →
--type layout - UX: "UX", "usability", "user experience", "flow", "onboarding" →
--type ux - Other: general design questions →
--type general
Options Reference
--query, -q Design question (required)
--type, -t Query type: general|color|layout|ux (default: general)
--n-results, -n Number of results (default: 3, max: 10)
--format, -f Output: markdown|json (default: markdown)
--topics Topic filter for general: color_theory,typography,layout,ux_principles,ui_patterns,responsive,css_techniques,visual_hierarchy,branding,navigation,forms_inputs,performance
--mood For color: professional|playful|calm|energetic|luxurious|trustworthy|modern|minimalist|bold|warm
--page-type For layout: landing_page|dashboard|blog|portfolio|ecommerce|settings|profile|search_results|form_page|documentation
--density For layout: low|medium|high
--user-context For UX: target user description
Response Guidelines
- Synthesize - Combine insights from multiple sources
- Adapt - Apply principles to user's specific context
- Be concise - Focus on actionable advice
- Cite when relevant - Mention which book informed the advice
Topics Covered
- Color Theory & Psychology
- Typography & Type Hierarchy
- Layout & Grid Systems
- UX Principles & Heuristics
- UI Patterns & Components
- Responsive Design
- CSS Techniques
- Visual Hierarchy
- Branding & Design Systems
- Navigation & Information Architecture
- Forms & Input Design
- Performance Optimization