使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/harshsinghmp/muse-skills --skill design开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
仓库原始内容
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
🎨 design — Website Design Department
One head skill for the whole design department. Creates original design from an idea, brief, or approved reference — structure first, then direction, then final art. Every decision is emitted as tokens and specs an engineer can build from.
Modes — quick commands
Every invocation resolves to exactly one mode. Match the request, then load only the matched reference:
| Mode | Trigger phrases | Behavior | Reference |
|---|---|---|---|
| ui | "design the homepage", "hi-fi mockup", "design this screen" | Full interface design pass: layout, hierarchy, tokens, states | references/ui.md |
| ux | "map the user flow", "improve the UX", "information architecture", "ux-architect", "ux-researcher", "persona-walkthrough", "onboarding-ux", "ux-patterns" | UX architecture, user research, persona cognitive walkthroughs, onboarding flows, heuristic audits | references/ux.md |
| wireframe | "wireframe the homepage", "low-fi layout", "structure first" | Grayscale structure with content plan, pre-visual-design | references/wireframe.md |
| logo | "design a logo", "new mark", "refresh our logo" | Logo concept territories → refinement → variants + usage rules | references/logo.md |
| branding | "brand identity", "brand guidelines", "brand system", "brandkit" | Full identity system: color, type, spacing, voice → brand.md + tokens | references/branding.md |
| socials | "social templates", "post designs", "profile kit" | Social template system: profiles, post formats, grid consistency | references/socials.md |
| graphics | "banner", "OG image", "hero art", "flyer", "banner-creator" | One-off graphic assets: banners, OG/social share, print-adjacent | references/graphics.md |
| prototype | "prototype this flow", "clickable mock", "test the riskiest screen first" | Riskiest-visual-unknown-first clickable mock → fast test → locked/iterate/kill verdict | references/prototype.md |
| uikit | "uikit", "ui kit", "component library", "starwind-ui", "stitch-design-taste", "design system components", "primitives" | Component libraries, headless primitives, Starwind UI / Tailwind component kits, tokens-to-components | references/uikit.md |
| story | "visual storytelling", "visual narrative", "storyboard", "data storytelling", "infographic narrative", "emotional journey" | Visual narrative design: story arcs (setup → conflict → resolution), video storyboards, infographics/data storytelling, emotional journeys, cross-platform visual adaptations | references/story.md |
| 3d | "3d scene", "spline", "three.js", "r3f", "blender model", "3d asset optimization" | Interactive 3D web scenes, Spline embeds, Three.js/R3F setups, and glTF optimization | references/3d.md |
Only the resolved mode's reference is loaded — the rest stay on disk, saving tokens on every run.
When to Use
- Designing a new site, page, or dashboard from a brief, idea, or approved mood references.
- Creating wireframes, user flows, or information architecture before any visual design.
- Designing a logo or full brand identity system (colors, type, voice rules).
- Building a social template system or graphic assets (banners, covers, OG images).
- Building industry-specific landing pages using structured layout templates (e.g. SaaS, Developer Tools).
Layout Templates & Vertical Selector Matrix
Every landing page or homepage design MUST strictly match the client's industry vertical. Never apply technical or code-first templates to non-developer verticals:
| Vertical Type | Target Buyer / User | Canonical Template / Flow | Core Elements & Visual Language |
|---|---|---|---|
| Developer Tools & Infrastructure | Software Engineers, DevOps, Architects | templates/developer.md | 1-line install, code grid, zero-auth demo, architecture diagram, GitHub stars |
| B2B SaaS (Business / Ops) | Founders, Managers, Execs, Sales/Ops | templates/saas.md | 9-section problem-to-solution, ROI justification, enterprise logos, value tiers |
| E-Commerce & Retail | Consumers, Shoppers, Retail Buyers | Route to webdev:ecommerce / Retail flow | Lifestyle imagery, product catalog/grid, variant selector, cart, reviews |
| Professional Services & Agencies | Clients seeking consulting/services | Route to brand:pipeline / Service Lead-gen | Deliverable scope, client case studies, team credentials, booking CTA |
| Local Business & Healthcare | Local clientele (clinics, legal, trade) | Local Lead-Gen flow | Location/hours, phone/booking CTA, service menu, verified testimonials |
| Creator, Media & Communities | Readers, listeners, community members | Media / Newsletter flow | Content samples, subscriber count, episode highlights, community benefits |
Layout template details:
- SaaS (
templates/saas.md): Canonical 9-section problem-solving landing page layout (Header/Nav → Hero → Logos/Trust Marquee → Features → Product Showcase → Pricing → Testimonials → Final CTA → Footer) aligned with 9 copywriting frameworks (AIDA, PASTOR, 4 P's, PRUNE, SLAP, So What?, PAPA, Star-Story-Solution, SPIN). - Developer (
templates/developer.md): Canonical 7-block developer homepage layout (Hero with 1-Command Install → Frictionless Demo / Playground → Architecture & Mechanics → Code-First Feature Grid → Developer Social Proof & OSS Stats → Quickstart & Integration Surface → Transparent Pricing & License) synthesized from Jakub Czakon's developer marketing framework. Strict negative guards prevent application to non-technical verticals.
Anti-Triggers
- Improving or refactoring an existing interface →
refactor-ui. - Extracting a design system from a reference (screenshot/URL/Figma) →
designscope. - Adding motion or animation →
animate. - Scaffolding the project repository →
new-project.
Quick Reference
Department intake gate (every run)
| Question | Why |
|---|---|
| What is the business goal of this design? | Design without a goal is decoration |
| Who is the audience, and on what device/context? | Audience picks hierarchy, not taste |
| What brand inputs exist (tokens, brand doc, logo)? | Existing brand wins — never invent over it |
| What references or mood direction is approved? | Prevents rework after hi-fi |
Client has a live brand but no tokens → run designscope on their site first.
Deliverable ladder
| Stage | Mode | Approved before next? |
|---|---|---|
| Structure | wireframe, ux | Yes |
| Direction | ui style tile, branding tokens | Yes |
| Final art | ui hi-fi, logo, socials, graphics | Yes |
Skipping an approval gate is how rework happens.
Defaults (client tokens override whenever they exist)
- Spacing: 4px base scale — 4/8/12/16/24/32/48/64.
- Type: one display + one text family, 1.25 (minor third) scale.
- Color roles: primary (brand), action (CTA), neutral (text/surface), semantic (success/warn/danger).
- Contrast: 4.5:1 body text, 3:1 large text — verified before delivery.
- Output shape: decisions as tokens (OKLCH/hex, DTCG naming) + component specs, not just pictures.
Procedure
- Intake. run the department intake gate in Quick Reference; client brand inputs win over invented direction every time.
- Resolve the mode. Match the request against the mode table; exactly one mode. Ambiguous → ask one question, then proceed.
- Execute the mode playbook. Load
references/<mode>.mdand follow its Intake → Deliverable → Procedure → Quality gate in order. - Gate and deliver. Pass this file's Verification checklist plus the mode's quality gate, then deliver the artifact where the client expects it.
Pitfalls
- Designing hi-fi before structure is agreed — rework machine. Wireframe approval comes first.
- Inventing brand colors when the client already has a brand —
designscopetheir assets; existing tokens win. - More than 2 type families, or decorative faces on body text.
- Happy-path-only components — every component needs hover, focus, disabled, loading, empty, and error states.
- Page-to-page aesthetic drift — one token set per project, extended, never forked.
- Delivering pictures without specs or tokens — engineers guess, pixels drift.
- Wrong mode resolved (branding request treated as ui) — deliverable shape is wrong; re-route.
Verification
- [ ] Exactly one mode resolved and its reference playbook followed end to end.
- [ ] Every visual decision traces to an intake input (goal, audience, brand, or approved reference).
- [ ] Text/background pairs pass AA: 4.5:1 body, 3:1 large text.
- [ ] Spacing and type come from a stated scale; at most 2 type families.
- [ ] Components specified with all interactive states and responsive behavior.
- [ ] Existing-brand work used the client's tokens verbatim — nothing invented over them.
