responsive-design — Claude Code skill: responsive layouts
Guides responsive UI work with mobile-first styles, container queries, and fluid values. Use it when pages or components need to adapt to available space.
/plugin marketplace add wshobson/agents
/plugin install ui-design@claude-code-workflowsWhat responsive-design does
This skill guides an agent through responsive layout work. It starts from mobile styles, places breakpoints around content rather than device models, and prefers fluid values for typography and spacing. Its scope includes CSS Grid, Flexbox, responsive images, navigation, tables, and media.
For component-level changes, it points to container queries, with deeper patterns in references/details.md. It also covers horizontal overflow, fixed widths, mobile 100vh issues, distorted images, and 44x44px touch targets. Install it if responsive CSS is regular project work; for a one-off static page, the extra guidance is unnecessary.
What it helps with
- build a mobile-first page layout
- add container queries to a component
- fix horizontal overflow
- choose content-based breakpoints
- keep typography and spacing fluid
Example prompts for the agent
- "Make this page mobile-first and check for horizontal overflow."
- "Rework the card with container queries so it responds to its container width."
- "Use CSS Grid for a responsive table and keep images from stretching."
How to install responsive-design
1Plugin marketplace
/plugin marketplace add wshobson/agents/plugin install ui-design@claude-code-workflowsThis installs the whole ui-design plugin with all its skills
2Skills CLI (Vercel)
npx skills add wshobson/agents --skill responsive-design -a claude-code3Manually: put the files in place
~/.claude/skills/responsive-design/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/responsive-design/
1Skills CLI (Vercel)
npx skills add wshobson/agents --skill responsive-design -a codex2Manually: put the files in place
.agents/skills/responsive-design/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add wshobson/agents --skill responsive-design -a cursor2Manually: put the files in place
.cursor/skills/responsive-design/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install wshobson/agents responsive-design2Manually: put the files in place
.github/skills/responsive-design/SKILL.mdPlatform CLI
gemini skills install https://github.com/wshobson/agents --path plugins/ui-design/skills/responsive-designManually: put the files in place
.devin/skills/responsive-design/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set213
The whole set →Similar
Questions about responsive-design
How do I install responsive-design in Claude Code?
Run npx skills add wshobson/agents --skill responsive-design -a claude-code. The skill file is placed at ~/.claude/skills/responsive-design/SKILL.md.
What does responsive-design do?
The skill guides responsive UI work with mobile-first styles, container queries, fluid typography, CSS Grid, and Flexbox. It also addresses common mobile layout issues.
How does responsive-design choose breakpoints?
It recommends setting breakpoints around content instead of device types. For component-level responsiveness, it uses container queries.
Source text
SKILL.md · MIT
--- 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 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
© Seth Hobson · MIT · wshobson/agents