gracefullight/pkgs / .agents/skills/oma-design
oma-design
UnverifiedDefine or review a visual system, DESIGN.md, or redesign direction. Use for typography, layout, color, motion, and interaction design decisions.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.1 KB |
| examples/design-context-example.md | markdown | 2.3 KB |
| examples/landing-page-prompt.md | markdown | 4.8 KB |
| reference/accessibility.md | markdown | 4.4 KB |
| reference/color-and-contrast.md | markdown | 3.7 KB |
| reference/component-patterns.md | markdown | 5.7 KB |
| reference/motion-design.md | markdown | 7.9 KB |
| reference/responsive-design.md | markdown | 3.6 KB |
| reference/shader-and-3d.md | markdown | 5.0 KB |
| reference/spatial-design.md | markdown | 2.8 KB |
| reference/typography.md | markdown | 2.6 KB |
| reference/visual-hierarchy.md | markdown | 9.6 KB |
| resources/anti-patterns.md | markdown | 8.4 KB |
| resources/asset-strategy.md | markdown | 3.0 KB |
| resources/checklist.md | markdown | 5.6 KB |
| resources/design-md-spec.md | markdown | 8.3 KB |
| resources/design-tokens.md | markdown | 3.9 KB |
| resources/error-playbook.md | markdown | 3.9 KB |
| resources/execution-protocol.md | markdown | 14.5 KB |
| resources/getdesign-fetcher.md | markdown | 13.2 KB |
| resources/prompt-enhancement.md | markdown | 9.2 KB |
| resources/redesign-protocol.md | markdown | 3.7 KB |
| resources/stitch-integration.md | markdown | 3.8 KB |
reference/spatial-design.md
View on GitHub# Spatial Design Reference
## Base Unit: 8px Grid
All spacing derives from an 8px base unit (4px for fine adjustments).
### Spacing Scale
| Token | Value | Use |
|-------|-------|-----|
| 1 | 4px | Fine adjustments, icon padding |
| 2 | 8px | Tight spacing, inline gaps |
| 3 | 12px | Small component padding |
| 4 | 16px | Default padding, gap between related items |
| 6 | 24px | Section sub-spacing |
| 8 | 32px | Component separation |
| 12 | 48px | Section internal padding |
| 16 | 64px | Section vertical padding (mobile) |
| 24 | 96px | Section vertical padding (desktop) |
| 32 | 128px | Hero section padding |
## Grid System
- 12-column grid for page layouts
- Responsive gutters: 16px (mobile) → 24px (tablet) → 32px (desktop)
- Max content width: 1280px (xl) or 1024px (lg) for text-heavy content
- Always center content with `mx-auto`
## Responsive Breakpoints
| Name | Width | Typical Use | Columns |
|------|--------|----------------------|---------|
| sm | 640px | Large phones | 1-2 |
| md | 768px | Tablets | 2-3 |
| lg | 1024px | Small laptops | 3-4 |
| xl | 1280px | Desktops | 4+ |
| 2xl | 1536px | Large displays | 4+ |
## Section Spacing Patterns
| Section Type | Mobile (py) | Desktop (py) |
|----------------|------------------|------------------|
| Hero | py-24 (96px) | py-40 (160px) |
| Content | py-16 (64px) | py-32 (128px) |
| Stats/CTA | py-16 (64px) | py-24 (96px) |
| Footer | py-8 (32px) | py-12 (48px) |
Horizontal padding: `px-4` (mobile) → `px-6 md:px-16 lg:px-24`
### Within Sections
- Between heading and content: space-y-4 (16px)
- Between content blocks: space-y-8 (32px) or space-y-12 (48px)
- Card grid gap: gap-4 (mobile) → gap-6 (desktop)
## Touch Targets (Mobile)
- Minimum tappable area: **44x44pt** (Apple HIG) / **48x48dp** (Material)
- Spacing between adjacent targets: minimum 8px
- Safe area: respect notch, home indicator, and rounded corners
- Thumb-friendly zones: place primary actions in bottom half of screen
## Content Width & Readability
- Optimal line length: 45-75 characters
- For full-width sections: constrain text with `max-w-md` or `max-w-lg`
- For centered hero text: `max-w-4xl` or `max-w-5xl`
## Anti-Patterns
- DON'T: Mix spacing values outside the 8px scale
- DON'T: Use padding less than 16px on mobile containers
- DON'T: Force identical card heights with arbitrary min-height
- DON'T: Ignore horizontal overflow on mobile
- DO: Maintain consistent section rhythm (same py across similar sections)
- DO: Test at 375px viewport width as minimum mobile target
- DO: Use `gap` instead of margins for grid/flex children
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |