mcpField
R
responsive-design

responsive-design

github.com/wshobsonDesign & UI41.9k21.3k installsUpdated 2w ago
Repository

About responsive-design

A design skill for building interfaces that adapt to different screen sizes and device contexts. It covers mobile-first layouts, CSS responsiveness, and common implementation issues.

Key features

  1. 01Mobile-first layout guidance
  2. 02Container query patterns
  3. 03Fluid typography and spacing
  4. 04CSS Grid and Flexbox layouts
  5. 05Responsive media and navigation

Use cases

  1. 01Building layouts for mobile and desktop
  2. 02Choosing content-based breakpoints
  3. 03Adapting components with container queries
  4. 04Troubleshooting overflow and touch targets

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wshobson/agents --skill responsive-design

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

Bundled files

References and scripts installed along with SKILL.md.

references/
breakpoint-strategies.md
container-queries.md
details.md
fluid-layouts.md

Details

From the project README

Responsive Design

Master modern responsive design techniques to create interfaces that adapt seamlessly across all screen sizes and device contexts.

When to Use This Skill

  • Implementing mobile-first responsive layouts
  • Using container queries for component-based responsiveness
  • Creating fluid typography and spacing scales
  • Building complex layouts with CSS Grid and Flexbox
  • Designing breakpoint strategies for design systems
  • Implementing responsive images and media
  • Creating adaptive navigation patterns
  • Building responsive tables and data displays

Detailed patterns and worked examples

Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.

Best Practices

  1. Mobile-First: Start with mobile styles, enhance for larger screens
  2. Content Breakpoints: Set breakpoints based on content, not devices
  3. Fluid Over Fixed: Use fluid values for typography and spacing
  4. Container Queries: Use for component-level responsiveness
  5. Test Real Devices: Simulators don't catch all issues
  6. Performance: Optimize images, lazy load off-screen content
  7. Touch Targets: Maintain 44x44px minimum on mobile
  8. Logical Properties: Use inline/block for internationalization

Common Issues

  • Horizontal Overflow: Content breaking out of viewport
  • Fixed Widths: Using px instead of relative units
  • Viewport Height: 100vh issues on mobile browsers
  • Font Size: Text too small on mobile
  • Touch Targets: Buttons too small to tap accurately
  • Aspect Ratio: Images squishing or stretching
  • Z-Index Stacking: Overlays breaking on different screens

Comments

Markdown supported