What does this skill help with?

It guides the agent to build responsive interfaces using container queries, fluid typography, CSS Grid, and mobile-first breakpoints, including best practices for content-based breakpoints, touch target sizing, and performance.

Does it cover common responsive bugs?

Yes. It covers horizontal overflow, fixed widths, viewport height issues on mobile browsers, small font sizes, undersized touch targets, aspect ratio problems, and z-index stacking that breaks on different screens.

Where are the detailed patterns kept?

Detailed pattern documentation lives in references/details.md. The agent reads that file when the navigation tier in the main skill is not enough.

Responsive Design

SkillMedia

A skill that guides an AI agent through building responsive web layouts with modern CSS. It covers container queries, fluid typography, CSS Grid, and mobile-first breakpoint strategies, and it helps when you are building adaptive interfaces or component-level responsive behavior. The skill also includes a reference file with detailed patterns and notes on common problems like horizontal overflow and viewport height bugs.

Connect your AI Use it in a pipeline

Then ask your AI: use the Responsive Design skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.

No other account needed.

Have an AI agent that can load skills and read files from your project.

What your AI can do with it

Implement mobile-first responsive layouts
Use container queries for component-based responsiveness
Create fluid typography and spacing scales
Build complex layouts with CSS Grid and Flexbox
Design breakpoint strategies for design systems
Handle responsive images, tables, and navigation patterns

Getting started

Have an AI agent that can load skills and read files from your project.
Add the responsive-design skill to the agent's available skills.
Ask the agent to build or adjust a layout, naming the components and screens involved.
If the agent needs more detail, let it read references/details.md for the full patterns.

What this skill tells your AI

The instructions your AI receives, as published by wshobson/agents in plugins/ui-design/skills/responsive-design/SKILL.md and read by Ahel’s review.

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

Signals

GitHub stars: 40k
Forks: 4k
Last commit: Oct 2026

Questions

What does this skill help with?: It guides the agent to build responsive interfaces using container queries, fluid typography, CSS Grid, and mobile-first breakpoints, including best practices for content-based breakpoints, touch target sizing, and performance.
Does it cover common responsive bugs?: Yes. It covers horizontal overflow, fixed widths, viewport height issues on mobile browsers, small font sizes, undersized touch targets, aspect ratio problems, and z-index stacking that breaks on different screens.
Where are the detailed patterns kept?: Detailed pattern documentation lives in references/details.md. The agent reads that file when the navigation tier in the main skill is not enough.

Advanced

Item type: skill
Key: responsive-design-wshobson
Source: github.com/wshobson/agents

github.com/wshobson/agents