muapi-design-guide — Claude Code skill: what it does, how to install
Generates brand identity assets, including color palettes, font pairings, UI previews, and mockups. Useful when establishing a clear visual style for a new product.
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-design-guide -a claude-code
npx skills add SamurAIGPT/Generative-Media-Skills --skill design-guide -a claude-codeWhat muapi-design-guide does
This skill directs the agent to generate visual brand assets through the muapi CLI tool. The process runs across three sequential phases. First, it renders a reference card showing five color swatches with hex codes alongside a typography pairing guide. Next, it produces a design spec sheet displaying UI components such as buttons, input fields, cards, and badges. The final step generates photorealistic mockups showing stationery and an app icon.
Graphic generation uses three dedicated models: bytedance-seedream-v4.5, gpt4o-text-to-image, and nano-banana-pro. Once images are ready, the skill provides a written summary containing the suggested font stack, hex values, spacing rules, and usage constraints.
Asset generation fails immediately if MUAPI_API_KEY is missing or if muapi auth configure was not run beforehand.
What it helps with
- Build a five-color brand palette with precise hex values
- Select functional font pairings for headers and running text
- Create a visual specification card for core UI components
- Produce brand mockups for stationery and mobile application icons
Example prompts for the agent
- Create a design system for a fintech startup named FinFlow using a dark luxury aesthetic
- Generate a brand style guide for an organic skincare line named Flora with deep green as the primary color
- Build a visual identity package and mockups for a boutique hotel chain called Aurora
How to install muapi-design-guide
1Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-design-guide -a claude-codenpx skills add SamurAIGPT/Generative-Media-Skills --skill design-guide -a claude-code2Manually: put the files in place
~/.claude/skills/design-guide/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/design-guide/
1Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill design-guide -a codex2Manually: put the files in place
.agents/skills/design-guide/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill design-guide -a cursor2Manually: put the files in place
.cursor/skills/design-guide/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install SamurAIGPT/Generative-Media-Skills design-guide2Manually: put the files in place
.github/skills/design-guide/SKILL.md1Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill design-guide -a gemini-cli2Platform CLI
gemini skills install https://github.com/SamurAIGPT/Generative-Media-Skills --path library/visual/design-guideManually: put the files in place
.devin/skills/design-guide/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill design-guide -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about muapi-design-guide
How to install muapi-design-guide in Claude Code?
Run npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-design-guide -a claude-code in your terminal.
What does muapi-design-guide do?
It orchestrates the creation of visual branding by generating palette cards, font pairing sheets, interface kit previews, and physical mockups.
What prerequisites are needed to run this skill?
You must have the muapi CLI available and set up with an active MUAPI_API_KEY.
Source text
SKILL.md · MIT
---
slug: muapi-design-guide
name: muapi-design-guide
version: "1.0.0"
description: Create a comprehensive brand design guide — color palette, typography pairings, UI component previews, and visual identity rules with example mockups.
acceptLicenseTerms: true
---
# Brand Design Guide
**Create a comprehensive brand design guide — color palette, typography pairings, UI component previews, and visual identity rules with example mockups.**
## Inputs
| Name | Type | Required | Default | Description |
|:---|:---|:---|:---|:---|
| `brand_name` | text | yes | — | The brand or product name. |
| `industry` | text | yes | — | Industry/niche (e.g. "fintech startup", "organic skincare", "luxury hotel chain"). |
| `style_direction` | text | no | modern, minimal, premium | Design aesthetic (e.g. "bold and playful", "corporate and trustworthy", "dark luxury"). |
| `primary_color` | text | no | — | Optional brand primary color (hex code or color name, e.g. "#3898EC" or "deep navy"). |
| `existing_logo` | image_url | no | — | Optional existing logo to extract brand cues from. |
## Steps
This skill runs THREE parallel generation phases, all in a single the plan.
### Phase A — Color & Typography Reference Card
1. **Color palette card** — `muapi image generate` (model=`bytedance-seedream-v4.5`):
- Prompt: `Clean design guide color palette card for {{brand_name}} — {{style_direction}} style brand for {{industry}}. Shows 5 swatches: primary, secondary, accent, background, text. Each swatch labeled with hex code. Modern design reference card, white background, editorial typography, flat design.`
- If `{{primary_color}}` is given, include it: `primary color is {{primary_color}}`
- Aspect ratio: 16:9
2. **Typography pairing preview** — `muapi image generate` (model=`bytedance-seedream-v4.5`):
- Prompt: `Brand typography pairing sheet for {{brand_name}} — {{style_direction}}. Shows heading font (large, bold), subheading font (medium), body font (small regular), and caption font. Includes font names, sizes, and usage rules. Clean white background, professional design reference.`
- Aspect ratio: 16:9
### Phase B — UI Component Preview
3. **UI components mockup** — `muapi image generate` (model=`gpt4o-text-to-image`):
- Prompt: `{{brand_name}} brand design system UI kit — {{style_direction}} for {{industry}}. Shows: primary button, secondary button, input field, card component, badge/tag, icon set sample. Consistent brand colors and fonts. Professional design spec sheet, light mode, high detail, Figma-style component documentation.`
- Aspect ratio: 4:3
### Phase C — Brand Application Mockup
4. **Real-world mockup** — `muapi image generate` (model=`nano-banana-pro`):
- Prompt: `{{brand_name}} brand identity applied to real-world mockups — {{style_direction}} style for {{industry}}. Shows business card, letterhead, and mobile app icon all with consistent brand identity. Professional brand presentation, clean background, photorealistic mockups.`
- If `{{existing_logo}}` provided, use `muapi image edit` (model=`nano-banana-pro-edit`) with it as reference.
- Aspect ratio: 4:3
After all assets generate:
- Present all 4 assets together as a cohesive design guide
- Provide a written text summary with: suggested font stack, hex codes, spacing rules, and do/don't guidelines
- Offer to generate a social media template or logo next
## Notes
- All prompts should reinforce {{style_direction}} consistently across all phases.
- If {{primary_color}} is blank, derive one from the {{industry}} and {{style_direction}} context.
## Trigger Keywords
`design guide`, `brand guide`, `style guide`, `design system`, `brand identity`, `visual identity`, `brand colors`, `typography`
---
## Notes for the Executing Agent
- This recipe is LLM-orchestrated: read each phase, gather any missing inputs from the user, then call `muapi` CLI commands. Use `muapi auth configure` first if `MUAPI_API_KEY` is unset.
- For model IDs without a CLI alias yet, fall back to the raw endpoint via `curl -X POST https://api.muapi.ai/api/v1/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}'` and poll with `muapi predict wait <request_id>`.
- Substitute `{{input_name}}` placeholders with the user's actual inputs before issuing each call.
© SamurAIGPT · MIT · SamurAIGPT/Generative-Media-Skills