What is the responsive-web-design skill?
The responsive-web-design skill is a compact SKILL.md from the secondsky plugin collection. It teaches your coding agent a mobile-first base with min-width breakpoints at 640 and 1024 pixels, a one, two and three column grid, clamp based fluid type, fluid images and a responsive flexbox navigation.
responsive-web-design is a small skill in the secondsky collection. Its SKILL.md describes building adaptive interfaces with Flexbox, CSS Grid and media queries, using a mobile-first approach for multi-device layouts and flexible UI systems.
It is mostly ready to paste CSS. Six short examples show the patterns, followed by a best practices list and links to the MDN Flexbox and Grid guides.
What changes in your agent's output
- Base styles target a 320 pixel mobile screen, with min-width queries at 640 and 1024 pixels adding padding and max widths
- Grid layouts start as one column, move to two on tablet and three on desktop
- Headings and body text use clamp so size scales smoothly between breakpoints
- Images get max-width 100 percent and auto height, with 16 by 9 aspect ratio and object-fit cover for heroes
- Navigation stacks in a column on mobile and becomes a row at 768 pixels
The best practices list adds flexible units, testing on real devices, touch targets of at least 48 pixels and line lengths of 45 to 75 characters. For breakpoint and container query depth, see wshobson-responsive-design.
Who it is for
Best for
- Developers who want a consistent mobile-first baseline in generated CSS
- Small projects where a short rule set is enough
- Teams that want the same layout defaults across agents
Not for
- Container queries or complex fluid systems, which this skill does not cover
- Auditing an existing layout. It gives patterns, not a review process
- Projects with a fixed design system whose breakpoints differ from 640 and 1024 pixels
Use it with UiChemy
If you build WordPress pages with UiChemy Composer, you can paste the same breakpoint and fluid type patterns into the CSS it writes, then check each breakpoint in the Elementor or Gutenberg preview.
How to install Responsive Web Design Skill: Mobile-First CSS Patterns
git clone https://github.com/secondsky/claude-skills.gitThe repo README lists cross agent options; Cursor needs a separate installer route, so check its table for your tool.Clone the repo
Run the command above. The skill is in plugins/responsive-web-design/skills/responsive-web-design with a SKILL.md.
Copy the folder
Copy it into ~/.claude/skills/ or a project's .claude/skills/. The README also describes a Claude Code plugin install and a Codex CLI route for the repo's plugins.
Ask for a layout
Request a responsive page or component and tell the agent to follow the responsive-web-design skill.
Check that it loaded
Ask your agent for a card grid and a nav bar. The CSS should start with mobile styles, then add min-width queries at 640, 768 and 1024 pixels and use clamp for headings.
Key features
- Mobile base firstWrite base styles for a 320 pixel screen with 1rem padding, then add larger layouts only inside min-width media queries.
- Tablet breakpointAt 640 pixels the container gets 2rem padding, a 640 pixel max width and automatic side margins.
- Desktop breakpointAt 1024 pixels the container max width grows to 1024 pixels, keeping the same pattern as the tablet step.
- Flexible gridA grid with a 1rem gap is one column on mobile, repeat 2 on tablet and repeat 3 on desktop.
- Fluid typographyh1 uses clamp from 1.5rem to 3rem with 4vw in the middle, and paragraphs use clamp from 1rem to 1.25rem.
- Responsive imagesAll images get max-width 100 percent and auto height, and hero images use a 16 by 9 aspect ratio with object-fit cover.
- Flexbox navigationThe nav is a column with a 0.5rem gap on mobile and a row with space between at 768 pixels.
- Touch and reading rulesKeep touch targets at 48 pixels or more and lines between 45 and 75 characters for readability.
- Grid versus flexboxUse CSS Grid for two dimensional layouts and Flexbox for one dimensional ones.
Frequently asked questions
What is the responsive-web-design skill?
It is a short SKILL.md from the secondsky collection that teaches a coding agent mobile-first responsive CSS. It covers media queries, a flexible grid, fluid typography with clamp, responsive images and a flexbox navigation, plus a short best practices list.
How do I install the responsive-web-design skill?
Clone secondsky/claude-skills and copy plugins/responsive-web-design/skills/responsive-web-design into your agent's skills folder, such as ~/.claude/skills/. The README also gives a Claude Code marketplace route and a Codex CLI plugin route, so use whichever fits your agent.
Which breakpoints does the skill use?
The examples use 640 pixels for tablet and 1024 pixels for desktop, with a base for 320 pixel screens and a navigation switch at 768 pixels. Treat them as starting points and change them if your design system defines other widths.
Does the skill cover container queries?
No. The SKILL.md focuses on viewport media queries, Grid, Flexbox, clamp and image rules. If you need container queries and fluid layout systems, wshobson-responsive-design covers them, and owl-responsive-design adds breakpoint patterns.
What touch target size does it recommend?
The best practices say to ensure a minimum of 48 pixel touch targets, to maintain readable line lengths of 45 to 75 characters and to test on real devices. These are short reminders, not an audit procedure.
Is the responsive-web-design skill free?
Yes. The frontmatter lists the MIT license and the secondsky repo is MIT licensed. The skill is a single text file with CSS examples, so the only setup is copying its folder into your agent's skills directory.
Which agents can use the skill?
The README says the repo ships Claude Code marketplace plugins and Codex CLI plugins, and notes that Cursor needs a different route because it expects its own plugin manifest. Other agents can copy the SKILL.md folder manually.
What should I pair with responsive-web-design?
Pair it with frontend-responsive-ui for more mobile-first CSS rules, or mobile-experience-report to review how a live page behaves on small screens. Check the final layout in a real browser at each breakpoint.


