responsive-design
wshobson/agents
Build adaptive interfaces with container queries, fluid typography, and mobile-first CSS Grid layouts.
What is responsive-design?
Implement modern responsive design using container queries, fluid typography, CSS Grid, and mobile-first breakpoint strategies. Use this skill when building adaptive interfaces, implementing fluid layouts, or creating component-level responsive behavior that works seamlessly across all screen sizes.
- Implement mobile-first responsive layouts with content-based breakpoints
- Use container queries for component-level responsiveness independent of viewport
- Create fluid typography and spacing scales that adapt to screen size
- Build complex layouts with CSS Grid and Flexbox
- Design and implement responsive images and media handling
- Create adaptive navigation patterns and responsive tables
How to install responsive-design
npx skills add https://github.com/wshobson/agents --skill responsive-designHow to use responsive-design
- 1.Start with mobile-first CSS, defining base styles for small screens
- 2.Set content-based breakpoints where layout breaks rather than device-specific widths
- 3.Use fluid values (rem, em, %) instead of fixed pixels for typography and spacing
- 4.Implement container queries for components that need to respond to their container size
- 5.Test on real devices and browsers to catch viewport and touch target issues
- 6.Optimize images with responsive srcset and lazy loading for performance
- 7.Apply logical properties (inline/block) instead of left/right for better internationalization
Use cases
- Building a design system with responsive components that adapt based on container size rather than viewport
- Creating a mobile-first e-commerce site with fluid typography that scales smoothly from phone to desktop
- Implementing responsive data tables that reorganize columns on smaller screens
- Designing adaptive navigation that switches from hamburger menu to horizontal bar at appropriate breakpoints
- Building responsive image galleries with proper aspect ratio handling across devices
- Frontend developers building responsive web applications
- UI/UX designers implementing design systems
- Full-stack developers creating adaptive interfaces
- Teams building component libraries with responsive behavior
responsive-design FAQ
Use container queries for component-level responsiveness that's independent of viewport size. Use viewport breakpoints for page-level layout changes and global design decisions. Often you'll use both together.
Use relative units (%, rem, em) instead of fixed pixel widths, set max-width on containers, use overflow-wrap and word-break for text, and test with real devices. Avoid fixed positioning that can break viewport bounds.
Maintain at least 44x44px (or 44x44 logical pixels) for interactive elements on mobile devices. This ensures users can tap accurately without frustration.
Avoid 100vh on mobile as it doesn't account for browser UI. Use 100% height, dvh (dynamic viewport height), or JavaScript to calculate actual viewport height instead.
Use srcset and sizes attributes to serve appropriately sized images for different screen sizes, or use picture element for art direction. Always include proper aspect-ratio CSS to prevent layout shift.
Full instructions (SKILL.md)
Source of truth, from wshobson/agents.
name: responsive-design description: Implement modern responsive layouts using container queries, fluid typography, CSS Grid, and mobile-first breakpoint strategies. Use when building adaptive interfaces, implementing fluid layouts, or creating component-level responsive behavior.
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
- Mobile-First: Start with mobile styles, enhance for larger screens
- Content Breakpoints: Set breakpoints based on content, not devices
- Fluid Over Fixed: Use fluid values for typography and spacing
- Container Queries: Use for component-level responsiveness
- Test Real Devices: Simulators don't catch all issues
- Performance: Optimize images, lazy load off-screen content
- Touch Targets: Maintain 44x44px minimum on mobile
- 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
Related skills
More from wshobson/agents and the wider catalog.
tailwind-design-system
Build production-ready design systems with Tailwind CSS v4, design tokens, and component libraries.
typescript-advanced-types
Master TypeScript's advanced type system: generics, conditional types, mapped types, and utility types for type-safe applications.
nodejs-backend-patterns
Build production-ready Node.js backends with Express/Fastify, middleware patterns, auth, and database integration.
python-performance-optimization
Profile and optimize Python code using cProfile, memory profilers, and performance best practices.
brand-landingpage
Brand-first landing page designer with guided interviews and Stitch-powered iteration.
python-testing-patterns
Implement comprehensive testing strategies with pytest, fixtures, mocking, and test-driven development.