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 |
resources/stitch-integration.md
View on GitHub# Stitch MCP Integration (Optional)
## Overview
Google Stitch is an AI-powered UI design platform. Its MCP server enables
coding agents to interact with design projects programmatically.
Stitch MCP is **optional**; all 7 phases of the design workflow work
without it. It adds visual preview and design extraction capabilities.
## Prerequisites
### Option A: API Key (Recommended, simplest)
1. Go to [stitch.withgoogle.com](https://stitch.withgoogle.com/)
2. Profile → Stitch Settings → API Keys → Create Key
3. Set environment variable: `STITCH_API_KEY="your-key"`
### Option B: OAuth (Google Cloud)
```bash
npx @_davideast/stitch-mcp init
```
The wizard handles gcloud auth, API enablement, and MCP config.
### Option C: Manual gcloud
```bash
gcloud auth application-default login
gcloud config set project <PROJECT_ID>
gcloud beta services mcp enable stitch.googleapis.com --project=<PROJECT_ID>
```
## MCP Client Configuration
### Claude Code
```bash
claude mcp add stitch -e STITCH_API_KEY=YOUR_KEY -- npx @_davideast/stitch-mcp proxy
```
### Cursor / VS Code (.cursor/mcp.json or .vscode/mcp.json)
```json
{
"mcpServers": {
"stitch": {
"command": "npx",
"args": ["@_davideast/stitch-mcp", "proxy"],
"env": { "STITCH_API_KEY": "YOUR_KEY" }
}
}
}
```
## Namespace Discovery
MCP tool names may be prefixed. Before calling, discover the prefix:
1. Call `list_tools` to enumerate available tools
2. Look for tools containing "list_projects", "get_screen", etc.
3. Use the discovered prefix (e.g., `mcp_stitch:list_projects`)
## Tool Mapping by Workflow Phase
### Phase 2: EXTRACT
| Step | Tool | Input |
|------|------|-------|
| Find projects | `list_projects` | filter: "view=owned" |
| Get design theme | `get_project` | resource name → designTheme object |
| List screens | `list_screens` | numeric project ID |
| Download HTML | `get_screen_code` | projectId, screenId |
| Download screenshot | `get_screen_image` | projectId, screenId (returns base64 PNG) |
### Phase 4: PROPOSE
| Step | Tool | Input |
|------|------|-------|
| Generate concept | `generate_screen_from_text` | text prompt + design context |
| Generate variants | `generate_variants` | existing screen ID |
| Preview | `get_screen_image` | for visual comparison |
### Phase 5: GENERATE
| Step | Tool | Input |
|------|------|-------|
| Build site | `build_site` | projectId + routes: [{screenId, route}] |
| Get page HTML | `get_screen_code` | per route |
## Available Tools
### Upstream (proxy + direct)
| Tool | Description |
|------|-------------|
| `list_projects` | List all accessible Stitch projects |
| `get_project` | Get project details (including designTheme) |
| `list_screens` | List screens within a project |
| `get_screen` | Get screen metadata and download URLs |
| `generate_screen_from_text` | Generate new screen from text prompt |
| `edit_screens` | Edit existing screens via text prompt |
| `generate_variants` | Generate design variants of a screen |
### Virtual (proxy only)
| Tool | Description |
|------|-------------|
| `build_site` | Map screens to routes, fetch HTML in parallel |
| `get_screen_code` | Retrieve screen + download HTML content |
| `get_screen_image` | Retrieve screen + download screenshot as base64 |
## Without Stitch
All workflow phases function without Stitch MCP:
| Phase | With Stitch | Without Stitch |
|-------|-------------|----------------|
| EXTRACT | API-based token extraction | Manual URL HTML/CSS analysis or skip |
| PROPOSE | Visual screen generation + screenshots | Text-based concept descriptions |
| GENERATE | build_site + get_screen_code | Direct code generation from DESIGN.md |
## Troubleshooting
```bash
# Verify configuration
npx @_davideast/stitch-mcp doctor --verbose
# Full reset
npx @_davideast/stitch-mcp logout --force --clear-config
npx @_davideast/stitch-mcp init
```
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: 198k | 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: 198k | 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: 198k | Updated | Claude CodeCodex | Verified | Install |