PluginBench
Skill
Pass
Audit score 90

adapt

pbakaus/impeccable

Adapt designs across screen sizes, devices, and platforms with responsive layouts and context-aware patterns.

What is adapt?

This skill helps you rethink designs for different contexts—mobile, tablet, desktop, print, or email—rather than just scaling them. Use it when adapting to new screen sizes, input methods, devices, or usage contexts.

  • Assess adaptation challenges by identifying source and target contexts, device constraints, and interaction requirements
  • Plan context-specific strategies for mobile, tablet, desktop, print, and email layouts
  • Implement responsive breakpoints, fluid layouts, and touch-friendly interactions (44x44px minimum targets)
  • Apply layout techniques using CSS Grid, Flexbox, container queries, and media queries
  • Adapt navigation, content visibility, and information architecture per platform
  • Test across real devices, orientations, browsers, and input methods

How to install adapt

npx skills add https://github.com/pbakaus/impeccable --skill adapt
Prerequisites
  • Run /impeccable teach first to establish design context and principles
  • Gather information about target platforms, devices, and usage contexts
Claude Code
Cursor
Windsurf
Cline

How to use adapt

  1. 1.Invoke /impeccable to review design principles and follow the Context Gathering Protocol
  2. 2.Assess the adaptation challenge by identifying source context, target context, and specific challenges
  3. 3.Plan an adaptation strategy appropriate to your target platform (mobile, tablet, desktop, print, or email)
  4. 4.Implement adaptations using responsive techniques like breakpoints, media queries, and flexible layouts
  5. 5.Apply platform-specific patterns (e.g., touch targets, navigation styles, content prioritization)
  6. 6.Test thoroughly on real devices, multiple orientations, browsers, and input methods

Use cases

Good for
  • Converting a desktop web app to work on mobile with single-column layout and bottom navigation
  • Designing a tablet experience that supports both portrait and landscape orientations with master-detail views
  • Adapting a web design for print by removing interactive elements and adding page breaks
  • Creating responsive email templates that work across email clients with inline CSS and table layouts
  • Implementing touch-friendly interactions on a desktop app that now needs to support tablet users
Who it's for
  • Product designers adapting designs across multiple platforms
  • Frontend developers implementing responsive layouts
  • UX designers planning cross-device experiences
  • Design systems teams defining breakpoints and adaptation patterns

adapt FAQ

Is adaptation just scaling a design to different screen sizes?

No. Adaptation means rethinking the entire experience for the new context—different layouts, navigation patterns, content prioritization, and interaction methods. A mobile experience should feel native to mobile, not like a shrunk desktop.

What's the minimum touch target size?

44x44 pixels is the minimum recommended size for touch targets. Larger is better, and targets should have adequate spacing between them to prevent accidental taps.

Should I use generic breakpoints or content-driven breakpoints?

Prefer content-driven breakpoints—break the layout where the design actually breaks, not at arbitrary pixel values. However, common ranges are mobile (320-767px), tablet (768-1023px), and desktop (1024px+).

How do I test responsive designs accurately?

Test on real devices whenever possible, not just browser DevTools. Device emulation is helpful but imperfect. Test different orientations, browsers, operating systems, and input methods (touch, mouse, keyboard).

Should I hide core functionality on mobile?

No. If a feature matters to users, make it work on all platforms. Use progressive disclosure and prioritization instead of removing functionality entirely.

Full instructions (SKILL.md)

Source of truth, from pbakaus/impeccable.


name: adapt description: Adapt designs to work across different screen sizes, devices, contexts, or platforms. Implements breakpoints, fluid layouts, and touch targets. Use when the user mentions responsive design, mobile layouts, breakpoints, viewport adaptation, or cross-device compatibility. version: 2.1.1 user-invocable: true argument-hint: "[target] [context (mobile, tablet, print...)]"

Adapt existing designs to work effectively across different contexts - different screen sizes, devices, platforms, or use cases.

MANDATORY PREPARATION

Invoke /impeccable — it contains design principles, anti-patterns, and the Context Gathering Protocol. Follow the protocol before proceeding — if no design context exists yet, you MUST run /impeccable teach first. Additionally gather: target platforms/devices and usage contexts.


Assess Adaptation Challenge

Understand what needs adaptation and why:

  1. Identify the source context:

    • What was it designed for originally? (Desktop web? Mobile app?)
    • What assumptions were made? (Large screen? Mouse input? Fast connection?)
    • What works well in current context?
  2. Understand target context:

    • Device: Mobile, tablet, desktop, TV, watch, print?
    • Input method: Touch, mouse, keyboard, voice, gamepad?
    • Screen constraints: Size, resolution, orientation?
    • Connection: Fast wifi, slow 3G, offline?
    • Usage context: On-the-go vs desk, quick glance vs focused reading?
    • User expectations: What do users expect on this platform?
  3. Identify adaptation challenges:

    • What won't fit? (Content, navigation, features)
    • What won't work? (Hover states on touch, tiny touch targets)
    • What's inappropriate? (Desktop patterns on mobile, mobile patterns on desktop)

CRITICAL: Adaptation is not just scaling - it's rethinking the experience for the new context.

Plan Adaptation Strategy

Create context-appropriate strategy:

Mobile Adaptation (Desktop → Mobile)

Layout Strategy:

  • Single column instead of multi-column
  • Vertical stacking instead of side-by-side
  • Full-width components instead of fixed widths
  • Bottom navigation instead of top/side navigation

Interaction Strategy:

  • Touch targets 44x44px minimum (not hover-dependent)
  • Swipe gestures where appropriate (lists, carousels)
  • Bottom sheets instead of dropdowns
  • Thumbs-first design (controls within thumb reach)
  • Larger tap areas with more spacing

Content Strategy:

  • Progressive disclosure (don't show everything at once)
  • Prioritize primary content (secondary content in tabs/accordions)
  • Shorter text (more concise)
  • Larger text (16px minimum)

Navigation Strategy:

  • Hamburger menu or bottom navigation
  • Reduce navigation complexity
  • Sticky headers for context
  • Back button in navigation flow

Tablet Adaptation (Hybrid Approach)

Layout Strategy:

  • Two-column layouts (not single or three-column)
  • Side panels for secondary content
  • Master-detail views (list + detail)
  • Adaptive based on orientation (portrait vs landscape)

Interaction Strategy:

  • Support both touch and pointer
  • Touch targets 44x44px but allow denser layouts than phone
  • Side navigation drawers
  • Multi-column forms where appropriate

Desktop Adaptation (Mobile → Desktop)

Layout Strategy:

  • Multi-column layouts (use horizontal space)
  • Side navigation always visible
  • Multiple information panels simultaneously
  • Fixed widths with max-width constraints (don't stretch to 4K)

Interaction Strategy:

  • Hover states for additional information
  • Keyboard shortcuts
  • Right-click context menus
  • Drag and drop where helpful
  • Multi-select with Shift/Cmd

Content Strategy:

  • Show more information upfront (less progressive disclosure)
  • Data tables with many columns
  • Richer visualizations
  • More detailed descriptions

Print Adaptation (Screen → Print)

Layout Strategy:

  • Page breaks at logical points
  • Remove navigation, footer, interactive elements
  • Black and white (or limited color)
  • Proper margins for binding

Content Strategy:

  • Expand shortened content (show full URLs, hidden sections)
  • Add page numbers, headers, footers
  • Include metadata (print date, page title)
  • Convert charts to print-friendly versions

Email Adaptation (Web → Email)

Layout Strategy:

  • Narrow width (600px max)
  • Single column only
  • Inline CSS (no external stylesheets)
  • Table-based layouts (for email client compatibility)

Interaction Strategy:

  • Large, obvious CTAs (buttons not text links)
  • No hover states (not reliable)
  • Deep links to web app for complex interactions

Implement Adaptations

Apply changes systematically:

Responsive Breakpoints

Choose appropriate breakpoints:

  • Mobile: 320px-767px
  • Tablet: 768px-1023px
  • Desktop: 1024px+
  • Or content-driven breakpoints (where design breaks)

Layout Adaptation Techniques

  • CSS Grid/Flexbox: Reflow layouts automatically
  • Container Queries: Adapt based on container, not viewport
  • clamp(): Fluid sizing between min and max
  • Media queries: Different styles for different contexts
  • Display properties: Show/hide elements per context

Touch Adaptation

  • Increase touch target sizes (44x44px minimum)
  • Add more spacing between interactive elements
  • Remove hover-dependent interactions
  • Add touch feedback (ripples, highlights)
  • Consider thumb zones (easier to reach bottom than top)

Content Adaptation

  • Use display: none sparingly (still downloads)
  • Progressive enhancement (core content first, enhancements on larger screens)
  • Lazy loading for off-screen content
  • Responsive images (srcset, picture element)

Navigation Adaptation

  • Transform complex nav to hamburger/drawer on mobile
  • Bottom nav bar for mobile apps
  • Persistent side navigation on desktop
  • Breadcrumbs on smaller screens for context

IMPORTANT: Test on real devices, not just browser DevTools. Device emulation is helpful but not perfect.

NEVER:

  • Hide core functionality on mobile (if it matters, make it work)
  • Assume desktop = powerful device (consider accessibility, older machines)
  • Use different information architecture across contexts (confusing)
  • Break user expectations for platform (mobile users expect mobile patterns)
  • Forget landscape orientation on mobile/tablet
  • Use generic breakpoints blindly (use content-driven breakpoints)
  • Ignore touch on desktop (many desktop devices have touch)

Verify Adaptations

Test thoroughly across contexts:

  • Real devices: Test on actual phones, tablets, desktops
  • Different orientations: Portrait and landscape
  • Different browsers: Safari, Chrome, Firefox, Edge
  • Different OS: iOS, Android, Windows, macOS
  • Different input methods: Touch, mouse, keyboard
  • Edge cases: Very small screens (320px), very large screens (4K)
  • Slow connections: Test on throttled network

Remember: You're a cross-platform design expert. Make experiences that feel native to each context while maintaining brand and functionality consistency. Adapt intentionally, test thoroughly.