mcpField
M
muapi-ui-design

muapi-ui-design

github.com/samuraigptDesign & UI863 installsUpdated 4w ago
Repository

About muapi-ui-design

muapi-ui-design is a skill for AI agents that turns product requirements into technical specifications for high-fidelity UI mockups, wireframes, and design systems. It organizes components, platform layouts, and design tokens while accounting for usability and accessibility.

Key features

  1. 01Atomic component structure
  2. 02Responsive layouts for mobile and web
  3. 03Typography, spacing, and color tokens
  4. 04Usability and accessibility guidance
  5. 05Brief-to-UX specification

Use cases

  1. 01Drafting a SaaS dashboard design
  2. 02Planning a mobile app interface
  3. 03Defining a reusable design system

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/samuraigpt/muapi-skills --skill muapi-ui-design

After installing, type/muapi-ui-designin Claude Code to confirm it loaded.

Bundled filesscripts/generate-mockup.sh

Details

From the project README

🎨 UI/UX Design Mockup Skill

A specialized skill for AI Agents to architect high-fidelity digital interfaces. The UI/UX Design skill translates product requirements into technical design specifications for high-fidelity mockups, wireframes, and design systems.

Core Competencies

  1. Atomic Design Orchestration: Structuring interfaces from Atoms (buttons) to Organisms (headers) for system consistency.
  2. Platform-Specific Layouts: Designing for responsive breakpoints across Mobile (iOS/Android) and Web (SaaS/E-commerce).
  3. Design System Integration: Specifying typography scales, spacing tokens, and color palettes (Hex/HSL).
  4. Heuristic Awareness: Ensuring designs follow established usability principles (Nielsen's 10 Heuristics).

🏗️ Technical Specification

1. Intent Mapping Table
Creative IntentStyleLayout PatternFocus
Enterprise SaaSModern/CleanDashboard/GridData Density
Consumer AppGlassmorphismF-Pattern / CardsVisual Flair
E-commerceMinimalistZ-Pattern / Product GridConversion
PortfolioBrutalistAsymmetricIdentity
Utility/ToolNeomorphismControl PanelTactile Feedback
2. Design Tokens & Variables
  • Typography: Geometric Sans (Inter/Roboto) for tech; Serif (Playfair) for luxury.
  • Spacing: 8pt grid system for consistent rhythmic spacing.
  • Color: High-contrast accessible palettes (WCAG 2.1 compliant).
  • Elevation: Shadow-based depth vs. Flat design layers.

🧠 Prompt Optimization Protocol (Agent Instruction)

Before calling the script, the Agent MUST expand the user's requirements into a Design Specification:

  1. ATOMIC STRUCTURE: Mention specific components (Atoms): Glassmorphic buttons, Input fields with 4px radius, Iconic sidebars.
  2. HIERARCHY: Use layout patterns: F-Pattern for content-heavy sites, Z-Pattern for landing pages, Grid-based Dashboards.
  3. TYPOGRAPHY & TOKENS: Injected design tokens: Inter Sans-serif, 8pt spacing system, WCAG high-contrast colors.
  4. NO SKEUOMORPHISM: Ensure the prompt enforces Flat Design or Glassmorphism to avoid "photograph-of-screen" results.

🚀 Protocol: Using the UI Designer

Step 1: Define the Product Brief

Provide the agent with a feature list and target audience.

Step 2: Invoke the Script

The generate-mockup.sh script expands the brief using internal knowledge of design systems.

# Designing a Fintech Mobile App
bash scripts/generate-mockup.sh \
  --desc "crypto wallet home with price charts" \
  --platform mobile \
  --theme dark \
  --style glassmorphism

⚠️ Constraints & Guardrails

  • Device Realism: MANDATORY - Do not show hands, physical phones, or desks. Generate pure UI/UX mockups only.
  • Accessibility: Avoid low-contrast text on bright backgrounds.
  • Complexity: Keep "Atoms" consistent across a single page generation.
  • Text Rendering: Use Flux for legible headers; specify placeholder text for smaller body copy.

⚙️ Implementation Details

This skill translates a high-level DESCRIPTION into a UX_BRIEF that specifies layout patterns, design tokens, and aesthetic constraints for the core/media/generate-image.sh primitive.

Comments

Markdown supported