Skip to content

gracefullight/pkgs / .agents/skills/oma-design

oma-design

Unverified

Define or review a visual system, DESIGN.md, or redesign direction. Use for typography, layout, color, motion, and interaction design decisions.

examples/design-context-example.md

View on GitHub
# .design-context.md — Example

This is an example of what `.design-context.md` looks like after Phase 1 (Setup).
The file lives in the project root and captures project-specific design decisions.

---

## Project
- **Name**: Apex Revenue Platform
- **Type**: B2B SaaS landing page + dashboard
- **Languages**: English (primary), Korean (secondary)

## Target Audience
- **Role**: Sales leaders, revenue ops managers, growth teams
- **Tech level**: Moderate — comfortable with dashboards, not developers
- **Age range**: 28-45
- **Context**: Evaluating tools during work hours, often on laptop

## Brand Personality
- Professional but not corporate
- Confident and forward-looking
- Data-driven, precise language
- Avoids jargon and buzzwords

## Aesthetic Direction
- **Theme**: Dark premium (Apple-inspired)
- **Mood**: Confident, spacious, sophisticated
- **Surface treatment**: Glass morphism for UI chrome, solid for content areas
- **Visual accents**: Subtle green (#22c55e) for CTAs and data highlights
- **Texture**: Prefer noise/grain over gradients for visual interest

## Typography
- **Body**: Pretendard Variable (CJK support for Korean) + system-ui fallback
- **Headings**: Instrument Serif italic for hero/display headings only
- **Mono**: JetBrains Mono for data tables and code snippets
- **Justification**: CJK support required for Korean localization

## Color Direction
- **Background**: Deep near-black (#0a0a0a)
- **Text**: Warm off-white (#f5f0eb) — not pure white
- **Primary accent**: Signal Green (#22c55e) — CTAs, success states
- **Avoid**: Purple gradients, rainbow effects, mesh gradients
- **Borders**: White at 10% opacity (rgba(255,255,255,0.1))

## Accessibility
- **Level**: WCAG AA minimum
- **Motion**: prefers-reduced-motion support required
- **Contrast**: 4.5:1 for normal text, 3:1 for large text
- **Touch targets**: 44x44pt minimum on mobile

## Reference Sites
- [linear.app](https://linear.app) — clean dark UI, minimal, professional
- [vercel.com](https://vercel.com) — developer-premium aesthetic, great typography
- [stripe.com](https://stripe.com) — strong hierarchy, purposeful animation

## Component Preferences
- **Base**: shadcn/ui for all foundational components
- **Effects**: Aceternity UI for hero parallax, React Bits for text animations
- **Animation**: motion/react for transitions, GSAP for scroll-triggered reveals
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall