MCPInstall

responsive-paradigms

Mobile, tablet and desktop are different paradigms, not one layout scaled. Use when designing responsive layouts or deciding what each breakpoint shows.

Installs
888
Last 24h
+9
Trending rank
#9318
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/dembrandt/dembrandt-skills --skill responsive-paradigms
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads responsive-paradigms automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Responsive Paradigms

Mobile, tablet, and desktop are fundamentally different interaction contexts. The input method, screen real estate, viewing distance, and session intent all differ. Responsive design is not the same layout at different widths — it is a different design decision at each breakpoint.

The Three Paradigms

Mobile (< 768px)

  • Input: Touch — fingers, not a cursor. Tap targets ≥ 44×44px.
  • Navigation: Bottom tab bar (thumb reachable) or hamburger drawer. Top navigation is hard to reach.
  • Session: Often interrupted, task-focused, shorter. Show the most important thing first.
  • Content: Single column. Vertical scroll only. No hover states.
  • Primary action: Floating action button (FAB) or full-width button at the bottom of the screen.

Tablet (768px–1024px)

  • Input: Touch and sometimes keyboard/trackpad. Hybrid paradigm.
  • Navigation: Can support a persistent sidebar at landscape orientation; collapses to drawer at portrait.
  • Content: Two-column layouts work. Master-detail patterns (list + detail side by side) are natural.
  • Primary action: Can be in-line with content, not necessarily floating.

Desktop (> 1024px)

  • Input: Mouse with hover states, keyboard shortcuts, precise clicking.
  • Navigation: Persistent sidebar or top navigation. Both visible simultaneously.
  • Content: Multi-column, dense information, toolbars, context menus.
  • Primary action: In-context with content, supported by keyboard shortcuts for power users.

Section Behaviour Across Breakpoints

Not every section needs to appear on every breakpoint at the same position — or at all.

Sections can be hidden on mobile

Secondary content (related articles, supplementary sidebars, decorative illustrations) can be hidden below a breakpoint. Ask: does a mobile user need this? If no, display: none at mobile is correct.

Stacking is the default; repositioning is allowed within the same container

The default responsive move is simply to stack — a horizontal row of blocks becomes a vertical column as the viewport narrows. This preserves order and grouping, so the user's mental model of the page survives the breakpoint unchanged. Reach for it first.

Repositioning an element is also allowed — but only if it stays within roughly the same container area / region. A sidebar that sits to the left on desktop can move below the main content on mobile, or collapse into an expandable section: it's still "the stuff next to / around the main content", just re-flowed. That's fine.

What to avoid: repositioning that moves an element into a different container or scope — a control lifted from its card into the global header reads as a different UI, not a reflow. Keep the parent region stable; change only how it flows within it.

Desktop:              Mobile:
[Main] [Sidebar]  →   [Main]
                       [▼ Related]  ← collapsed accordion, still "around the main content"

Sticky behaviour can change per breakpoint

An element that is position: sticky on desktop may need to become a fixed bottom bar on mobile, or be removed from sticky positioning entirely to free up screen space.

.toolbar {
  position: static; /* mobile: inline, not sticky */
}

@media (min-width: 1024px) {
  .toolbar {
    position: sticky;
    top: var(--header-height);
  }
}

Navigation transforms completely

DesktopMobile
Persistent top nav or sidebarBottom tab bar or hamburger drawer
Visible labels + iconsIcons only (bottom nav) or full list (drawer)
Hover states on nav itemsNone — touch only
Dropdowns on hoverTap to expand, full-screen or sheet

Labels can be shortened — but the full meaning must be recoverable

As space tightens, a label can be shortened or dropped to icon-only. Shortening hides information, so keep the full version reachable — the same "clamp + recover" contract as truncated text (see [[repeated-component-alignment]]):

  • Recover it via title / aria-label (required for icon-only controls), or in a detail view / the desktop layout.
  • Icon-only is valid only if the icon is unambiguous and still carries its label via aria-label. A cryptic icon is worse than the long word.

Mobile-First Approach

Design and build mobile first, then enhance for larger screens. Mobile forces prioritisation — what makes it onto mobile is what actually matters.

/* Mobile first: base styles are mobile */
.container { padding: var(--space-4); }

/* Enhance for larger screens */
@media (min-width: 768px) {
  .container { padding: var(--space-8); }
}

@media (min-width: 1024px) {
  .container {
    display: grid;
    grid-template-columns: 1fr 300px;
    gap: var(--space-8);
  }
}

/* Ultra-wide protection */
@media (min-width: 1600px) {
  .container {
    max-width: 1440px;
    margin-left: auto;
    margin-right: auto;
  }
}

Max-Width and Ultra-Wide Screens

Responsive design doesn't mean "expand forever." On very large monitors (2K, 4K, and ultra-wide), content must be capped to maintain readability and ergonomic comfort.

  • Ergonomics: Spreading critical UI elements across the full width of a 4K screen requires excessive neck movement and makes the interface feel "fragmented."
  • Readability: As noted in typography guidelines, line lengths should not exceed ~75 characters. On a 4K screen without a max-width, a single line of text could span thousands of pixels.
  • The "Safe Zone": Use a max-width container (typically between 1280px and 1600px) for all primary content.
  • Full-Bleed Exceptions: Background colours, decorative images, and secondary footers can remain full-width to maintain the design's "energy" while the content remains centered and contained.

Header chrome across breakpoints

A fixed header follows the same paradigms. The brand mark and the menu control both scale, and both keep the same inset from the edge.

  • Scale the brand mark. A logo sized for desktop dominates a phone: smaller on mobile, moderate on tablet, full on desktop. A wordmark around 18 to 24px tall reads cleanly in a mobile header. Constrain by height and let width follow so the aspect ratio holds.
  • Match the edge inset. Logo and menu control sit at opposite edges with the same inset, scaling with the breakpoint. Too tight reads as cramped and risks colliding with rounded display corners.

Wrapped rows inherit the parent's alignment

A row of pills, stats, or tags built with flex-wrap keeps its own alignment when it wraps. In a centered mobile column the wrapped line hugs the left while everything around it is centered, leaving a lone trailing item in the corner. Match the inner alignment to the context: centered on mobile, left on desktop.

Help Matches the Input in Hand

Show gestures on touch and keys on keyboard, decided from the pointer and hover media features, not from the viewport width that drives the layout. A key legend on a phone is dead weight; a narrow desktop window still has keys. Gestures with no visible affordance must be listed, because nothing else reveals them.

Review Checklist

  • Does mobile navigation use a bottom tab bar or drawer — not a top nav that requires thumb stretching?
  • Are touch targets ≥ 44×44px on all interactive elements?
  • Are secondary sections hidden or collapsed on mobile rather than just shrunk?
  • Does sticky positioning adapt per breakpoint — not every sticky desktop element stays sticky on mobile?
  • Is the layout built mobile-first with progressive enhancement upward?
  • Are hover-dependent interactions (tooltips, dropdowns) replaced with tap equivalents on touch?
  • Does the primary action remain reachable with one thumb on mobile?
  • Is the primary content capped with a max-width (e.g., 1440px) on ultra-wide/4K monitors?
  • Does the header brand mark scale with the breakpoint, with logo and menu control sharing the same edge inset?
  • Do wrapped rows (pills, stats, tags) match the alignment of the context they sit in, rather than defaulting to left in a centered column?
  • Is stacking the default reflow, with repositioning kept within an element's original container/region rather than moving it into a different scope?
  • Where labels are shortened or reduced to icon-only, is the full meaning recoverable (tooltip/aria-label, a kept-elsewhere label, or an unambiguous icon)?
  • Are input instructions chosen by pointer capability, with gestures listed where they have no affordance?

FAQ

What does the responsive-paradigms skill do?

Mobile, tablet and desktop are different paradigms, not one layout scaled. Use when designing responsive layouts or deciding what each breakpoint shows.

How do I install responsive-paradigms?

Run npx skills add https://github.com/dembrandt/dembrandt-skills --skill responsive-paradigms in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/responsive-paradigms/ (personal) or .claude/skills/responsive-paradigms/ (project).

Which AI agents can use responsive-paradigms?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is responsive-paradigms safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains responsive-paradigms?

It is published by dembrandt in dembrandt/dembrandt-skills. It has 888 recorded installs.

More from dembrandt/dembrandt-skills

View all →

nielsen-usability-heuristics

dembrandt/dembrandt-skills

Nielsen's 10 usability heuristics. Use when auditing an interface, designing interaction flows, writing error messages or reviewing usability.

Docs & Writing989 installs

performance-and-web-vitals

dembrandt/dembrandt-skills

Lighthouse audits and Core Web Vitals — LCP, CLS, INP. Use when optimising page load, layout shift, input delay, images, fonts or render-blocking resources.

color-mode-and-theme

dembrandt/dembrandt-skills

Light, dark or both, and when a theme selector is worth it. Use when defining a base palette or deciding on dark mode support.

Frontend & Design940 installs

ui-density

dembrandt/dembrandt-skills

Match information density to platform and user type. Use when designing data tables, dashboards or toolbars, or adapting a desktop product for mobile.

Frontend & Design927 installs

form-design

dembrandt/dembrandt-skills

Helper text, placeholders, validation and submit behaviour. Use when designing or reviewing a form, input field or data entry UI.

Frontend & Design925 installs

brand-visual-language

dembrandt/dembrandt-skills

Shape language across type, radius and icons carries brand personality. Use when starting a design system, picking icons or radius tokens, or reviewing visual consistency.

Marketing & SEO915 installs

Popular frontend & design skills

View category →

setup-matt-pocock-skills

mattpocock/skills

Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.

Frontend & Design1.1M installs

frontend-design

anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

OfficialFrontend & Design1M installs

hyperframes-animation

heygen-com/hyperframes

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

prototype

mattpocock/skills

Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.

Frontend & Design999.2K installs

hyperframes-core

heygen-com/hyperframes

The HyperFrames composition contract — build one renderable project. Use for composition structure, the data- timing attributes, class="clip", tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Frontend & Design930.5K installs

vercel-react-best-practices

vercel-labs/agent-skills

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

OfficialFrontend & Design843.1K installs