Skip to content

Keith-CY/idx.md / data

idx-md

Flagged

AgentSkill for https://idx.md. Use the index to locate AI agent library topics and fetch HEAD/BODY markdown.

FileKindSize
SKILL.mdskill md4.8 KB
agentskills-skill/BODY.mdmarkdown13.1 KB
agentskills-skill/HEAD.mdmarkdown792 B
agentskills-skill/vectors.jsonconfig1.2 KB
carmahhawwari-ui-design-brain-skill/BODY.mdmarkdown8.1 KB
carmahhawwari-ui-design-brain-skill/HEAD.mdmarkdown1.5 KB
carmahhawwari-ui-design-brain-skill/vectors.jsonconfig1.9 KB
category/ai-llms/index.mdmarkdown1.0 KB
category/calendar-scheduling/index.mdmarkdown1.1 KB
category/coding-agents-ides/index.mdmarkdown2.5 KB
category/communication/index.mdmarkdown9.7 KB
category/data-analytics/index.mdmarkdown10.8 KB
category/finance/index.mdmarkdown8.6 KB
category/git-github/index.mdmarkdown3.0 KB
category/index.mdmarkdown855 B
category/marketing-sales/index.mdmarkdown18.6 KB
category/productivity-tasks/index.mdmarkdown19.8 KB
category/search-research/index.mdmarkdown12.9 KB
category/security-passwords/index.mdmarkdown1.0 KB
category/transportation/index.mdmarkdown946 B
category/uncategorized/index.mdmarkdown495.0 KB
github-markup-readme/BODY.mdmarkdown3.3 KB
github-markup-readme/HEAD.mdmarkdown1.6 KB
github-markup-readme/vectors.jsonconfig2.0 KB
github-skill-actionbook-rust-skills-m04-zero-cost/BODY.mdmarkdown4.6 KB
github-skill-actionbook-rust-skills-m04-zero-cost/HEAD.mdmarkdown928 B
github-skill-actionbook-rust-skills-m04-zero-cost/vectors.jsonconfig1.6 KB
github-skill-agno-agi-agno-git-workflow-cdbf56f5/BODY.mdmarkdown2.2 KB
github-skill-agno-agi-agno-git-workflow-cdbf56f5/HEAD.mdmarkdown765 B
github-skill-agno-agi-agno-git-workflow-cdbf56f5/vectors.jsonconfig1.4 KB
github-skill-anthropics-knowledge-work-plugins-call-prep/BODY.mdmarkdown5.8 KB
github-skill-anthropics-knowledge-work-plugins-call-prep/HEAD.mdmarkdown987 B
github-skill-anthropics-knowledge-work-plugins-call-prep/vectors.jsonconfig1.7 KB
github-skill-composiohq-awesome-claude-skills-forcemanager-automation-185f86fa/BODY.mdmarkdown2.9 KB
github-skill-composiohq-awesome-claude-skills-forcemanager-automation-185f86fa/HEAD.mdmarkdown879 B
github-skill-composiohq-awesome-claude-skills-forcemanager-automation-185f86fa/vectors.jsonconfig1.7 KB
github-skill-composiohq-awesome-claude-skills-ip2location-io-automation-e171a20b/BODY.mdmarkdown3.0 KB
github-skill-composiohq-awesome-claude-skills-ip2location-io-automation-e171a20b/HEAD.mdmarkdown889 B
github-skill-composiohq-awesome-claude-skills-ip2location-io-automation-e171a20b/vectors.jsonconfig1.7 KB
github-skill-composiohq-awesome-claude-skills-kickbox-automation-3347ff5a/BODY.mdmarkdown2.9 KB
github-skill-composiohq-awesome-claude-skills-kickbox-automation-3347ff5a/HEAD.mdmarkdown854 B
github-skill-composiohq-awesome-claude-skills-kickbox-automation-3347ff5a/vectors.jsonconfig1.6 KB
github-skill-coreyhaines31-marketingskills-programmatic-seo/BODY.mdmarkdown7.2 KB
github-skill-coreyhaines31-marketingskills-programmatic-seo/HEAD.mdmarkdown1.0 KB
github-skill-coreyhaines31-marketingskills-programmatic-seo/vectors.jsonconfig1.8 KB
github-skill-darrenhinde-openagentscontrol-task-breakdown/BODY.mdmarkdown4.4 KB
github-skill-darrenhinde-openagentscontrol-task-breakdown/HEAD.mdmarkdown957 B
github-skill-darrenhinde-openagentscontrol-task-breakdown/vectors.jsonconfig1.7 KB
github-skill-davepoon-buildwithclaude-content-research-writer/BODY.mdmarkdown13.9 KB
github-skill-davepoon-buildwithclaude-content-research-writer/HEAD.mdmarkdown1004 B
github-skill-davepoon-buildwithclaude-content-research-writer/vectors.jsonconfig1.7 KB
github-skill-davila7-claude-code-templates-scientific-schematics/BODY.mdmarkdown23.2 KB
github-skill-davila7-claude-code-templates-scientific-schematics/HEAD.mdmarkdown1.1 KB
github-skill-davila7-claude-code-templates-scientific-schematics/vectors.jsonconfig1.9 KB
github-skill-davila7-claude-code-templates-writing-hookify-rules/BODY.mdmarkdown8.2 KB
github-skill-davila7-claude-code-templates-writing-hookify-rules/HEAD.mdmarkdown967 B
github-skill-davila7-claude-code-templates-writing-hookify-rules/vectors.jsonconfig1.7 KB
github-skill-deanpeters-product-manager-skills-pestel-analysis/BODY.mdmarkdown14.1 KB
github-skill-deanpeters-product-manager-skills-pestel-analysis/HEAD.mdmarkdown891 B
github-skill-deanpeters-product-manager-skills-pestel-analysis/vectors.jsonconfig1.6 KB
github-skill-dicklesworthstone-pi-agent-rust-deploying-monitoring-stacks/BODY.mdmarkdown3.9 KB
github-skill-dicklesworthstone-pi-agent-rust-deploying-monitoring-stacks/HEAD.mdmarkdown1.2 KB
github-skill-dicklesworthstone-pi-agent-rust-deploying-monitoring-stacks/vectors.jsonconfig2.0 KB
github-skill-dicklesworthstone-pi-agent-rust-websocket-client-creator/BODY.mdmarkdown2.2 KB
github-skill-dicklesworthstone-pi-agent-rust-websocket-client-creator/HEAD.mdmarkdown1.2 KB
github-skill-dicklesworthstone-pi-agent-rust-websocket-client-creator/vectors.jsonconfig2.0 KB
github-skill-dicklesworthstone-pi-agent-rust-windsurf-common-errors/BODY.mdmarkdown2.3 KB
github-skill-dicklesworthstone-pi-agent-rust-windsurf-common-errors/HEAD.mdmarkdown1.1 KB
github-skill-dicklesworthstone-pi-agent-rust-windsurf-common-errors/vectors.jsonconfig1.9 KB
github-skill-dlt-hub-dlt-review-pr/BODY.mdmarkdown8.7 KB
github-skill-dlt-hub-dlt-review-pr/HEAD.mdmarkdown713 B
github-skill-dlt-hub-dlt-review-pr/vectors.jsonconfig1.3 KB
github-skill-epicweb-dev-epic-stack-epic-ui-guidelines/BODY.mdmarkdown17.0 KB
github-skill-epicweb-dev-epic-stack-epic-ui-guidelines/HEAD.mdmarkdown768 B
github-skill-epicweb-dev-epic-stack-epic-ui-guidelines/vectors.jsonconfig1.5 KB
github-skill-florianbruniaux-claude-code-ultimate-guide-rtk-optimizer/BODY.mdmarkdown4.1 KB
github-skill-florianbruniaux-claude-code-ultimate-guide-rtk-optimizer/HEAD.mdmarkdown837 B
github-skill-florianbruniaux-claude-code-ultimate-guide-rtk-optimizer/vectors.jsonconfig1.6 KB
github-skill-github-awesome-copilot-copilot-instructions-blueprint-generator/BODY.mdmarkdown14.4 KB
github-skill-github-awesome-copilot-copilot-instructions-blueprint-generator/HEAD.mdmarkdown1.0 KB
github-skill-github-awesome-copilot-copilot-instructions-blueprint-generator/vectors.jsonconfig1.8 KB
github-skill-jeffallan-claude-skills-websocket-engineer/BODY.mdmarkdown6.4 KB
github-skill-jeffallan-claude-skills-websocket-engineer/HEAD.mdmarkdown872 B
github-skill-jeffallan-claude-skills-websocket-engineer/vectors.jsonconfig1.6 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-ideogram-common-errors/BODY.mdmarkdown4.4 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-ideogram-common-errors/HEAD.mdmarkdown1.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-ideogram-common-errors/vectors.jsonconfig2.0 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-juicebox-migration-deep-dive/BODY.mdmarkdown2.9 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-juicebox-migration-deep-dive/HEAD.mdmarkdown1.2 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-juicebox-migration-deep-dive/vectors.jsonconfig2.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-klingai-pricing-basics/BODY.mdmarkdown7.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-klingai-pricing-basics/HEAD.mdmarkdown1.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-klingai-pricing-basics/vectors.jsonconfig1.9 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-prisma-schema-helper/BODY.mdmarkdown2.2 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-prisma-schema-helper/HEAD.mdmarkdown1.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-prisma-schema-helper/vectors.jsonconfig2.0 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-testing-load-balancers/BODY.mdmarkdown6.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-testing-load-balancers/HEAD.mdmarkdown1.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-testing-load-balancers/vectors.jsonconfig1.9 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-twinmind-security-basics/BODY.mdmarkdown3.6 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-twinmind-security-basics/HEAD.mdmarkdown1.2 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-twinmind-security-basics/vectors.jsonconfig2.0 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-vercel-upgrade-migration/BODY.mdmarkdown6.0 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-vercel-upgrade-migration/HEAD.mdmarkdown1.2 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-vercel-upgrade-migration/vectors.jsonconfig2.0 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-websocket-client-creator/BODY.mdmarkdown2.3 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-websocket-client-creator/HEAD.mdmarkdown1.2 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-websocket-client-creator/vectors.jsonconfig2.0 KB
github-skill-kevoreilly-capev2-cape-sandbox-developer/BODY.mdmarkdown15.5 KB
github-skill-kevoreilly-capev2-cape-sandbox-developer/HEAD.mdmarkdown736 B
github-skill-kevoreilly-capev2-cape-sandbox-developer/vectors.jsonconfig1.4 KB
github-skill-kurtosis-tech-kurtosis-cluster-manage/BODY.mdmarkdown1.5 KB
github-skill-kurtosis-tech-kurtosis-cluster-manage/HEAD.mdmarkdown876 B
github-skill-kurtosis-tech-kurtosis-cluster-manage/vectors.jsonconfig1.5 KB
github-skill-luongnv89-claude-howto-brand-voice-consistency/BODY.mdmarkdown2.5 KB
github-skill-luongnv89-claude-howto-brand-voice-consistency/HEAD.mdmarkdown894 B
github-skill-luongnv89-claude-howto-brand-voice-consistency/vectors.jsonconfig1.6 KB
github-skill-mukul975-anthropic-cybersecurity-skills-analyzing-ransomware-leak-site-intelligence/BODY.mdmarkdown13.9 KB
github-skill-mukul975-anthropic-cybersecurity-skills-analyzing-ransomware-leak-site-intelligence/HEAD.mdmarkdown1.0 KB
github-skill-mukul975-anthropic-cybersecurity-skills-analyzing-ransomware-leak-site-intelligence/vectors.jsonconfig1.9 KB
github-skill-neolabhq-context-engineering-kit-sadd-multi-agent-patterns/BODY.mdmarkdown23.4 KB
github-skill-neolabhq-context-engineering-kit-sadd-multi-agent-patterns/HEAD.mdmarkdown973 B
github-skill-neolabhq-context-engineering-kit-sadd-multi-agent-patterns/vectors.jsonconfig1.7 KB
github-skill-novuhq-novu-react-email/BODY.mdmarkdown14.1 KB
github-skill-novuhq-novu-react-email/HEAD.mdmarkdown799 B
github-skill-novuhq-novu-react-email/vectors.jsonconfig1.4 KB
github-skill-onmax-nuxt-skills-nuxt-seo/BODY.mdmarkdown2.9 KB
github-skill-onmax-nuxt-skills-nuxt-seo/HEAD.mdmarkdown785 B
github-skill-onmax-nuxt-skills-nuxt-seo/vectors.jsonconfig1.4 KB
github-skill-openai-openai-agents-python-pr-draft-summary/BODY.mdmarkdown7.0 KB
github-skill-openai-openai-agents-python-pr-draft-summary/HEAD.mdmarkdown996 B
github-skill-openai-openai-agents-python-pr-draft-summary/vectors.jsonconfig1.7 KB
github-skill-openclaw-openclaw-gh-issues/BODY.mdmarkdown6.2 KB
github-skill-openclaw-openclaw-gh-issues/HEAD.mdmarkdown973 B
github-skill-openclaw-openclaw-gh-issues/vectors.jsonconfig1.6 KB
github-skill-prompt-security-clawsec-claw-release/BODY.mdmarkdown7.5 KB
github-skill-prompt-security-clawsec-claw-release/HEAD.mdmarkdown778 B
github-skill-prompt-security-clawsec-claw-release/vectors.jsonconfig1.4 KB
github-skill-quickwit-oss-quickwit-simple-pr/BODY.mdmarkdown2.3 KB
github-skill-quickwit-oss-quickwit-simple-pr/HEAD.mdmarkdown734 B
github-skill-quickwit-oss-quickwit-simple-pr/vectors.jsonconfig1.4 KB
github-skill-quickwit-oss-tantivy-simple-pr/BODY.mdmarkdown1.7 KB
github-skill-quickwit-oss-tantivy-simple-pr/HEAD.mdmarkdown730 B
github-skill-quickwit-oss-tantivy-simple-pr/vectors.jsonconfig1.4 KB
github-skill-resend-react-email-react-email/BODY.mdmarkdown14.1 KB
github-skill-resend-react-email-react-email/HEAD.mdmarkdown815 B
github-skill-resend-react-email-react-email/vectors.jsonconfig1.4 KB
github-skill-sickn33-antigravity-awesome-skills-hubspot-integration/BODY.mdmarkdown1.6 KB
github-skill-sickn33-antigravity-awesome-skills-hubspot-integration/HEAD.mdmarkdown940 B
github-skill-sickn33-antigravity-awesome-skills-hubspot-integration/vectors.jsonconfig1.7 KB
github-skill-sickn33-antigravity-awesome-skills-outlook-calendar-automation/BODY.mdmarkdown10.6 KB
github-skill-sickn33-antigravity-awesome-skills-outlook-calendar-automation/HEAD.mdmarkdown952 B
github-skill-sickn33-antigravity-awesome-skills-outlook-calendar-automation/vectors.jsonconfig1.7 KB
github-skill-sickn33-antigravity-awesome-skills-upstash-qstash/BODY.mdmarkdown1.4 KB
github-skill-sickn33-antigravity-awesome-skills-upstash-qstash/HEAD.mdmarkdown926 B
github-skill-sickn33-antigravity-awesome-skills-upstash-qstash/vectors.jsonconfig1.7 KB
github-skill-vllm-project-vllm-ascend-vllm-ascend-model-adapter/BODY.mdmarkdown8.5 KB
github-skill-vllm-project-vllm-ascend-vllm-ascend-model-adapter/HEAD.mdmarkdown968 B
github-skill-vllm-project-vllm-ascend-vllm-ascend-model-adapter/vectors.jsonconfig1.7 KB
github-skill-wavetermdev-waveterm-electron-api/BODY.mdmarkdown4.5 KB
github-skill-wavetermdev-waveterm-electron-api/HEAD.mdmarkdown803 B
github-skill-wavetermdev-waveterm-electron-api/vectors.jsonconfig1.5 KB
github-skill-zjunlp-skillnet-webshop-query-parser/BODY.mdmarkdown2.6 KB
github-skill-zjunlp-skillnet-webshop-query-parser/HEAD.mdmarkdown1.1 KB
github-skill-zjunlp-skillnet-webshop-query-parser/vectors.jsonconfig1.8 KB
ibelick-baseline-ui/BODY.mdmarkdown3.3 KB
ibelick-baseline-ui/HEAD.mdmarkdown957 B
ibelick-baseline-ui/vectors.jsonconfig1.4 KB
ibelick-fixing-accessibility/BODY.mdmarkdown4.6 KB
ibelick-fixing-accessibility/HEAD.mdmarkdown1.0 KB
ibelick-fixing-accessibility/vectors.jsonconfig1.5 KB
ibelick-fixing-metadata/BODY.mdmarkdown4.3 KB
ibelick-fixing-metadata/HEAD.mdmarkdown991 B
ibelick-fixing-metadata/vectors.jsonconfig1.4 KB
ibelick-fixing-motion-performance/BODY.mdmarkdown5.4 KB
ibelick-fixing-motion-performance/HEAD.mdmarkdown1.1 KB
ibelick-fixing-motion-performance/vectors.jsonconfig1.6 KB
index.mdmarkdown582.7 KB
industry/finance/index.mdmarkdown1.2 KB
industry/index.mdmarkdown169 B
industry/uncategorized/index.mdmarkdown145 B
knowledge-work-plugins-bio-research-skills-instrument-data-to-allotrope-skill/BODY.mdmarkdown10.5 KB
knowledge-work-plugins-bio-research-skills-instrument-data-to-allotrope-skill/HEAD.mdmarkdown1.3 KB
knowledge-work-plugins-bio-research-skills-instrument-data-to-allotrope-skill/vectors.jsonconfig2.1 KB
knowledge-work-plugins-bio-research-skills-nextflow-development-skill/BODY.mdmarkdown8.6 KB
knowledge-work-plugins-bio-research-skills-nextflow-development-skill/HEAD.mdmarkdown1.1 KB
knowledge-work-plugins-bio-research-skills-nextflow-development-skill/vectors.jsonconfig1.8 KB
knowledge-work-plugins-bio-research-skills-scientific-problem-selection-skill/BODY.mdmarkdown10.9 KB
knowledge-work-plugins-bio-research-skills-scientific-problem-selection-skill/HEAD.mdmarkdown1.3 KB
knowledge-work-plugins-bio-research-skills-scientific-problem-selection-skill/vectors.jsonconfig2.1 KB
knowledge-work-plugins-bio-research-skills-scvi-tools-skill/BODY.mdmarkdown7.2 KB
knowledge-work-plugins-bio-research-skills-scvi-tools-skill/HEAD.mdmarkdown1.4 KB
knowledge-work-plugins-bio-research-skills-scvi-tools-skill/vectors.jsonconfig2.1 KB
knowledge-work-plugins-bio-research-skills-single-cell-rna-qc-skill/BODY.mdmarkdown7.8 KB
knowledge-work-plugins-bio-research-skills-single-cell-rna-qc-skill/HEAD.mdmarkdown1.0 KB
knowledge-work-plugins-bio-research-skills-single-cell-rna-qc-skill/vectors.jsonconfig1.8 KB
knowledge-work-plugins-bio-research-skills-start-skill/BODY.mdmarkdown3.4 KB
knowledge-work-plugins-bio-research-skills-start-skill/HEAD.mdmarkdown963 B
knowledge-work-plugins-bio-research-skills-start-skill/vectors.jsonconfig1.6 KB
knowledge-work-plugins-cowork-plugin-management-skills-cowork-plugin-customizer-skill/BODY.mdmarkdown9.5 KB

carmahhawwari-ui-design-brain-skill/BODY.md

View on GitHub
---
name: ui-design-brain
description: Generate production-grade UI using real component patterns and best practices from 60+ documented interface components. Use when the user asks to build web interfaces, pages, dashboards, forms, navigation, or any UI — ensures modern, minimal, SaaS-quality output grounded in design system conventions rather than generic AI patterns.
license: Complete terms in LICENSE.txt
---

# UI Design Brain

This skill provides a curated knowledge base of 60+ UI component patterns sourced from [component.gallery](https://component.gallery) and enriched with best practices, layout guidance, and usage rules. It replaces generic guessing with real design-system knowledge when generating interfaces.

**Before writing any UI code**, consult this skill to select the right components and follow their best practices. Read [components.md](components.md) for the full reference.

## When to Use This Skill

Apply whenever the user asks to build, design, or generate:
- Web pages, landing pages, marketing sites
- SaaS dashboards, admin panels, settings pages
- Forms, data tables, navigation structures
- Modals, drawers, popovers, or overlay patterns
- Any React, HTML/CSS, or Tailwind UI component

## Design Philosophy

Every generated interface should feel **modern, minimal, and production-ready** — not like a template.

### Core Principles

1. **Restraint over decoration.** Fewer elements, highly refined. White space is a feature.
2. **Typography carries hierarchy.** Pair a distinctive display font with a clean body font. Maximize weight contrast between headings and labels.
3. **One strong color moment.** Neutral palette first (warm off-whites, near-blacks, muted mid-tones). Introduce one confident accent. If it could appear on a poster or book cover, it's probably timeless.
4. **Spacing is structure.** Use an 8 px grid. Tighter gaps group related elements; generous gaps let hero content breathe.
5. **Accessibility is non-negotiable.** WCAG AA contrast minimums. Focus indicators. Semantic HTML. Keyboard navigation.
6. **No generic AI aesthetics.** Avoid: purple-on-white gradients, Inter/Roboto defaults, evenly-spaced card grids, and cookie-cutter layouts. Every interface should feel designed for its specific context.

### Quality Bar

The output should match what you'd expect from a senior product designer at a top SaaS company:
- Clean visual rhythm with intentional asymmetry
- Obvious interactive affordances (hover, focus, active states)
- Graceful edge cases (empty states, loading, error)
- Responsive without breakpoint artifacts

## Workflow

### Step 1 — Identify Components

Read the user's request and determine which UI components are needed. Reference [components.md](components.md) to find each component by name or alias.

Common mappings:
- "navigation" → Header, Navigation, Breadcrumbs, Tabs
- "form" → Form, Text input, Select, Checkbox, Radio button, Button
- "data display" → Table, Card, List, Badge, Avatar
- "feedback" → Alert, Toast, Modal, Spinner, Progress bar, Empty state
- "input" → Text input, Textarea, Select, Combobox, Datepicker, File upload, Slider
- "overlay" → Modal, Drawer, Popover, Tooltip, Dropdown menu

### Step 2 — Apply Best Practices

For each component in the interface, follow its best practices from the reference. Key rules that apply broadly:

**Layout**
- Single-column forms — faster to scan
- Consistent vertical lanes in repeated rows (lists, tables)
- Fixed-width slots for icons and actions, even when empty
- Cards: media → title → meta → action hierarchy

**Interaction**
- Buttons: verb-first labels ("Save changes", not "Submit"), one primary per section
- Modals: always provide X, Cancel, and Escape; trap focus; return focus on close
- Toasts: auto-dismiss 4–6 s, allow manual dismiss, stack newest on top
- Toggles: immediate effect only — use checkboxes in forms that require Save

**Typography & Spacing**
- Strict heading hierarchy (h1 → h2 → h3), one h1 per page
- Minimum 44 px touch targets on mobile
- Labels above inputs (vertical forms) or beside (horizontal)
- Placeholder text as format hint, never as label replacement

**States**
- Empty states: illustration + helpful headline + primary CTA
- Loading: skeleton screens > spinners (show after 300 ms delay)
- Validation: inline on blur, not on every keystroke
- Disabled elements: visually distinct but still readable

### Step 3 — Choose a Design Direction

Select the style preset that best matches the user's intent, or ask if unclear:

**Modern SaaS** (default)
- Neutral palette, one strong accent
- 8 px grid, generous white space
- Clean, professional, spacious

**Apple-level Minimal**
- Near-monochrome, warm grays
- Large type hierarchy, tight tracking on display text
- Abundant white space, micro-interactions (150–250 ms ease-out)

**Enterprise / Corporate**
- Information-dense, well-defined regions
- Compact spacing scale (4/8/12/16/24 px)
- Robust form handling, fully keyboard-navigable

**Creative / Portfolio**
- Bold, expressive, strong visual personality
- Asymmetric layouts, dramatic scale contrast
- Editorial typography, vivid accent colors

**Data Dashboard**
- Data-dense, optimised for scannability
- Consistent vertical alignment across rows
- Clear metric hierarchy: KPI → trend → detail

### Step 4 — Generate Code

Write production-ready code following these rules:

```
Stack:       React + Tailwind CSS (unless user specifies otherwise)
Spacing:     Tailwind spacing scale (p-2, gap-4, etc.) on an 8px grid
Colors:      CSS variables or Tailwind config for palette consistency
Typography:  Tailwind text utilities; expressive font pairings via Google Fonts
States:      Implement hover, focus, active, disabled for all interactive elements
Responsive:  Mobile-first; test at 375, 768, 1440 px
Accessibility: Semantic HTML, ARIA where needed, focus management
```

## Component Quick Reference

Below are the 15 most commonly needed components. For the full 60+ component reference with best practices, aliases, and layout examples, see [components.md](components.md).

| Component | When to use | Key rule |
|-----------|------------|----------|
| **Button** | Trigger actions | Verb-first labels; one primary per section |
| **Card** | Represent an entity | Media → title → meta → action; shadow OR border, not both |
| **Modal** | Focused attention | Trap focus; X + Cancel + Escape to close |
| **Navigation** | Page/section links | 5–7 items max; clear active state |
| **Table** | Structured data | Sticky header; right-align numbers; sortable columns |
| **Tabs** | Switch panels | 2–7 tabs; active indicator; accordion on mobile |
| **Form** | Collect input | Single column; labels above; inline validation on blur |
| **Toast** | Brief confirmation | Auto-dismiss 4–6 s; undo action for destructive ops |
| **Alert** | Important status | Semantic colors + icon; max 2 sentences |
| **Drawer** | Secondary panel | Right for detail, left for nav; 320–480 px desktop |
| **Search input** | Find content | Cmd/Ctrl+K shortcut; debounce 200–300 ms |
| **Empty state** | No data | Illustration + headline + CTA; positive framing |
| **Skeleton** | Loading placeholder | Match actual layout shape; shimmer animation |
| **Badge** | Status/metadata label | 1–2 words; pill shape for status; limited color palette |
| **Dropdown menu** | Action/nav options | 7±2 items; destructive actions last in red |

## Anti-Patterns to Avoid

Never generate these — they signal generic, low-quality UI:

- **Rainbow badges** — every status a different bright color with no semantic meaning
- **Modal inside modal** — use a page or drawer for complex flows
- **Disabled submit with no explanation** — always indicate what's missing
- **Spinner for predictable layouts** — use skeleton screens instead
- **"Click here" links** — link text must describe the destination
- **Hamburger menu on desktop** — use visible navigation when space allows
- **Auto-advancing carousels** — let users control navigation
- **Placeholder-only form fields** — always use visible labels
- **Equal-weight buttons** — establish primary/secondary/tertiary hierarchy
- **Tiny text (< 12 px)** — body text minimum 14 px, prefer 16 px
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall