Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
aj-geddes avatar

Mobile First Design

  • 752 installs
  • 305 repo stars
  • Updated March 4, 2026
  • aj-geddes/useful-ai-prompts

mobile-first-design is a frontend agent skill that encodes responsive breakpoints, touch-target sizing, and mobile Core Web Vitals budgets for developers shipping web apps that must work on phones before desktop.

About

mobile-first-design is a useful-ai-prompts skill that starts layouts at 320–480px mobile widths, enhances at 768–1024px tablet, and optimizes desktop at 1200px plus with progressive enhancement. It bundles three reference guides—responsive-design-implementation, mobile-performance, and progressive-enhancement—and prescribes 44×44px minimum touch targets, hamburger navigation on small screens, and safe-area awareness for notched devices. Performance targets include mobile First Contentful Paint under 3 seconds, Largest Contentful Paint under 4 seconds, CLS under 100, JavaScript bundles under 100KB gzipped, and CSS under 50KB gzipped with critical CSS inlined. Image guidance covers responsive srcset, WebP with fallbacks, lazy loading, and CDN delivery. Testing guidance covers iPhone SE at 320px baseline, Samsung S21 at 360px, iPad at 768px, Chrome DevTools emulation, orientation changes, and slow-network verification on physical hardware. Developers reach for mobile-first-design when agents need concrete responsive rules instead of generic make-it-responsive advice.

  • Mobile Performance Optimization checklist covering image handling, metric goals, bundle size targets, and network strate
  • Progressive Enhancement layered approach with three explicit tiers: Core Content (HTML), Enhanced (CSS), and Interactive
  • Concrete device testing matrix including physical devices (iPhone SE, iPhone 13 Pro, Samsung S21, iPad) and emulation me
  • Quantified performance targets such as <3s FCP, <4s LCP, <100 CLS, <100KB JS, and <50KB CSS
  • Hard-gate checklist that must be satisfied before declaring a responsive UI complete

Mobile First Design by the numbers

  • 752 all-time installs (skills.sh)
  • Ranked #491 of 1,880 Design & UI/UX skills by installs in the Skillselion catalog
  • Security screen: LOW risk (skills.sh audit)
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/aj-geddes/useful-ai-prompts --skill mobile-first-design

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs752
repo stars305
Security audit3 / 3 scanners passed
Last updatedMarch 4, 2026
Repositoryaj-geddes/useful-ai-prompts

How do you implement mobile-first responsive web design?

Generate mobile-first performance rules, progressive enhancement checklists, and responsive testing guidance that keep web products fast and usable on any d

Who is it for?

Frontend developers building responsive SaaS or marketing sites who need explicit mobile performance thresholds and touch-friendly layout rules.

Skip if: Native iOS or Android app UI where platform SDK guidelines replace CSS breakpoint workflows.

When should I use this skill?

The user asks for mobile-first layout, responsive breakpoints, mobile Core Web Vitals targets, or touch-friendly UI patterns.

What you get

Breakpoint specifications, progressive enhancement checklists, mobile performance budgets, and device testing matrices.

  • responsive breakpoint specs
  • mobile performance checklists

By the numbers

  • Includes 3 reference guides for responsive design and performance
  • Specifies 44×44px minimum touch target size
  • Sets mobile JS budget under 100KB gzipped and CSS under 50KB gzipped

Files

SKILL.mdMarkdownGitHub ↗

Mobile-First Design

Table of Contents

Overview

Mobile-first design prioritizes small screens as the starting point, ensuring core functionality works on all devices while leveraging larger screens for enhanced experience.

When to Use

  • Web application design
  • Responsive website creation
  • Feature prioritization
  • Performance optimization
  • Progressive enhancement
  • Cross-device experience design

Quick Start

Minimal working example:

Mobile-First Approach:

Step 1: Design for Mobile (320px - 480px)
  - Constrained space forces priorities
  - Focus on essential content and actions
  - Single column layout
  - Touch-friendly interactive elements

Step 2: Enhance for Tablet (768px - 1024px)
  - Add secondary content
  - Multi-column layouts possible
  - Optimize spacing and readability
  - Take advantage of hover states

Step 3: Optimize for Desktop (1200px+)
  - Full-featured experience
  - Advanced layouts
  - Rich interactions
  - Multiple columns and sidebars

---
## Responsive Breakpoints:

Mobile: 320px - 480px
  - iPhone SE, older phones
// ... (see reference guides for full implementation)

Reference Guides

Detailed implementations in the references/ directory:

GuideContents
Responsive Design ImplementationResponsive Design Implementation
Mobile PerformanceMobile Performance
Progressive EnhancementProgressive Enhancement

Best Practices

✅ DO

  • Design for smallest screen first
  • Test on real mobile devices
  • Use responsive images
  • Optimize for mobile performance
  • Make touch targets 44x44px minimum
  • Stack content vertically on mobile
  • Use hamburger menu on mobile
  • Hide non-essential content on mobile
  • Test with slow networks
  • Progressive enhancement approach

❌ DON'T

  • Assume all mobile users have fast networks
  • Use desktop-only patterns on mobile
  • Ignore touch interaction needs
  • Make buttons too small
  • Forget about landscape orientation
  • Over-complicate mobile layout
  • Ignore mobile performance
  • Assume no keyboard (iPad users)
  • Skip mobile user testing
  • Forget about notches and safe areas

Related skills

How it compares

Use mobile-first-design for CSS breakpoint and performance budgets; use dedicated a11y audit skills when WCAG compliance testing is the primary goal.

FAQ

What mobile performance metrics does mobile-first-design target?

mobile-first-design targets mobile First Contentful Paint under 3 seconds, Largest Contentful Paint under 4 seconds, and Cumulative Layout Shift under 100. Bundle guidance caps JavaScript at 100KB gzipped and CSS at 50KB gzipped, with critical CSS inlined and responsive WebP imag

How many reference guides ship with mobile-first-design?

mobile-first-design bundles three reference guides under references/: responsive-design-implementation for breakpoint layouts, mobile-performance for image and network budgets, and progressive-enhancement for layered feature delivery. Each guide expands the quick-start YAML with

Is Mobile First Design safe to install?

skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.