Repository navigation
Mobile App Design
/mobile-app-design is the Mobile AI Agents skill for creating, redesigning, and reskinning mobile app UI.
Use it when you want a mobile app screen or flow to look production-ready, or when an existing app needs to feel visually new without breaking the business logic underneath.
Install the latest package:
npx mobile-ai-agents@latest installFor Claude Code, the command is installed here:
~/.claude/commands/mobile-app-design.md
Then use it in your AI coding tool:
/mobile-app-design
To install only this skill:
npx mobile-ai-agents@latest add skill mobile-app-design- Create new mobile app screens from a plain-English prompt.
- Redesign an existing screen so it feels modern and polished.
- Fully reskin an app while preserving behavior, APIs, state, analytics, and test IDs.
- Reorder tabs or navigation flows safely.
- Refresh themes, colors, typography, spacing, cards, icons, empty states, loading states, and error states.
- Turn screenshots, rough product ideas, Figma notes, or PRD text into buildable mobile UI.
| Platform | Default Implementation |
|---|---|
| Android | Kotlin, Jetpack Compose, Material 3 |
| iOS | Swift, SwiftUI |
| Flutter | Dart, Flutter Material 3 or Cupertino |
| React Native | React Native, TypeScript, Expo for new prototypes |
When the skill is used inside an existing repo, it should detect and follow the current stack, navigation, theme, components, and state management.
/mobile-app-design
Create a premium onboarding flow for a budgeting app.
Platform: Flutter.
Screens: welcome, connect bank, set monthly goal, dashboard preview.
Style: clean fintech, trustworthy, modern, light/dark ready.
/mobile-app-design
Reskin this React Native habit tracker so it feels like a premium wellness app.
Keep the same features and storage.
Reorder tabs to Today, Insights, Coach, Settings.
Update the theme, tab icons, cards, empty states, and loading states.
/mobile-app-design
Redesign the current checkout screen.
Make the primary action clearer, improve spacing, add error and loading states,
and keep all existing payment logic unchanged.
/mobile-app-design
Design-only spec for an iOS subscription screen.
Do not write code.
Include layout, components, states, interactions, accessibility, and implementation notes.
Use Reskin Mode when the app should look materially different, not just change color.
The skill should inspect:
- App entry points and navigation graph.
- Bottom tabs, drawers, stacks, sheets, and deep links.
- Main screens and shared components.
- Theme, color tokens, typography, spacing, radii, icons, and assets.
- State and data flow that must stay intact.
A strong reskin changes several of these:
- Navigation treatment.
- Tab order, labels, icons, and grouping.
- Screen hierarchy and section order.
- Card/list density and shape language.
- Typography scale and emphasis.
- Icon style.
- Empty, loading, error, offline, and permission states.
- Motion and micro-interactions.
The skill should preserve:
- Business logic.
- API contracts.
- Persistence.
- Analytics events.
- Permission behavior.
- Test IDs.
- Existing architecture and state management.
For a full mobile product loop:
/grill-mobile
Clarify the user, platform, core flow, constraints, and success criteria.
/mobile-app-design
Create, redesign, or reskin the screen or flow.
/prd-verification
Check the result against the PRD, design notes, and acceptance criteria.
/mobile-mcp-qa
Verify the UI on a real device, emulator, or simulator.
For implementation work, pair it with the platform-specific builders and test skills:
| Stack | Pair With |
|---|---|
| Android |
/android-tdd, /compose-review, compose-screen-builder
|
| iOS |
/ios-tdd, /swiftui-review, swift
|
| Flutter |
/flutter-tdd, /flutter-review, widget-generator
|
| React Native |
/rn-tdd, /rn-review, performance-optimizer
|
Before shipping a screen or reskin:
- Run the platform build, analyzer, typecheck, lint, or tests.
- Check small phone and large phone layouts.
- Verify safe areas, status bar, navigation bar, keyboard avoidance, and touch targets.
- Check loading, empty, error, offline, disabled, focused, pressed, and success states.
- Verify accessibility labels, contrast, dynamic type, and screen reader order.
- Capture screenshots with
/mobile-mcp-qawhen device proof is needed.
- Only changing colors and calling it a reskin.
- Adding a new design system instead of using existing theme tokens.
- Breaking route names, deep links, selected-tab state, analytics, or test IDs.
- Designing like a web landing page instead of a real app screen.
- Forgetting loading, empty, error, offline, and permission states.
/mobile-app-design
Reskin this app so it feels materially new while preserving all existing behavior.
First inspect navigation, screens, shared components, theme tokens, state flow, APIs, analytics, and test IDs.
Then propose a reskin plan covering navigation, theme, components, screens, states, risks, and verification.
After approval, implement with focused edits and run the relevant checks.
Getting Started
Documentation
- All Documentation
- Installation
- Figma MCP and Design Handoff
- Figma Spec Tools
- Core Loops
- Mobile Engineering Loop
- Mobile Memory
- Performance Loop
Reference
- Agents
- Platform Guide
- Skills and Prompts
- Android Device QA Setup
- Mobile App Design Skill
- Mobile Harness
- Enterprise Mobile Harness
- Workflows
- Reference
Community
Repository github.com/salmanashraf/mobile-ai-agents
Version: v1.0.38 · MIT License