agentleFS
Sign inStart free
launch52-ailaunch52-ai/flutter-template/.claude/skills/design/SKILL.md

design

Skill2 starsChanged 9 months agoMITView on GitHub

Design user interfaces with exceptional UX patterns. Use when implementing screens, reviewing UI code, choosing loading states, handling errors gracefully, placing interactive elements, adding animations, or ensuring the app feels polished and intuitive. Focuses on user experience details that make apps feel professional.

We split this skill into the rules it gives an agent

3 rules. 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 171 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Create interfaces that feel intuitive, responsive, and delightful.

    line 9
  2. Distinctive:

    Immediate feedback: - Every tap/action should have visible response

    line 24
  3. Very specific:

    Semantic labels: Use /a11y skill for Semantics widget patterns

    line 102

“Common” is measured: kept by at least 6 in 10 of the 171 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Design - UI/UX Implementation

Create interfaces that feel intuitive, responsive, and delightful. Focus on the small details that distinguish polished apps from mediocre ones.

When to Use This Skill

  • Implementing new screens or components
  • Reviewing UI code for UX issues
  • Deciding between loading state patterns
  • Placing buttons, CTAs, and interactive elements
  • Handling errors and edge cases gracefully
  • Adding animations and transitions
  • Choosing animation timing and curves

The Golden Rules

  1. Thumb-first design - Primary actions in the bottom 2/3 of the screen
  2. Immediate feedback - Every tap/action should have visible response
  3. Smart defaults - Auto-focus, pre-fill, remember preferences
  4. Graceful failures - Errors should guide, not blame
  5. Platform respect - iOS swipe-back, Android gestures, Material patterns
  6. Purposeful motion - Animate to communicate, not to impress

Core Principles

Every Action Deserves Feedback

Users should never wonder "did that work?" - provide visual press states, haptics, loading indicators, and success/error messages. See interaction-guide.md for details.

Auto-Focus Intelligence

Focus the right field at the right time - login screens should auto-focus email, search screens should auto-focus the search field. See interaction-guide.md for the complete decision table.

Error Recovery, Not Error Display

Errors should help users succeed. Instead of "Error: Invalid input", show "Email needs an @ symbol". See visual-guide.md for error state patterns.

Touch Targets

Minimum 48×48dp for all interactive elements. See interaction-guide.md for sizing guidelines.

Purposeful Animation

Animation should communicate change, not decorate. Use 300ms for transitions, match curves to motion direction, and always respect reduced motion preferences. See animation-guide.md for timing, curves, and patterns.

Quick Decisions

QuestionAnswer
Loading for <300ms?No indicator needed
Loading for 1-3s?Skeleton screen
Button action?Inline button loader
Full page load?Skeleton matching layout
File upload?Progress bar with percentage
Page transition duration?300ms (default)
Element entering screen?Use easeOutCubic curve
Element leaving screen?Use easeInCubic curve
Simple property change?Use implicit animation (AnimatedContainer)
Complex animation?Use explicit (AnimationController)

Workflow

  1. Before implementing: Where will the user's thumb be? What's the primary action? What if it fails? What animations are needed?
  2. During implementation: Touch targets ≥48dp, visual press states, appropriate loading pattern, natural animations.
  3. After implementation: Review against the checklists below and test with reduced motion enabled.

Guides

GuideUse For
interaction-guide.mdTouch targets, gestures, focus, keyboard, haptics
visual-guide.mdColors, loading states, dark mode, empty states
animation-guide.mdTiming, curves, page transitions, Hero, performance
platform-guide.mdiOS vs Android conventions
examples.mdComplete Flutter code patterns

UX Checklist

  • Primary action in thumb-friendly zone
  • All touch targets ≥48dp
  • Every interactive element has feedback
  • Loading state matches operation type
  • Error messages explain AND guide
  • Works in light and dark mode
  • iOS swipe-back not blocked
  • Accessibility: labels, focus order, reduced motion (see interaction-guide.md)

Animation Checklist

  • Page transitions feel natural (300ms default)
  • Curves match motion type (easeOut for enter, easeIn for exit)
  • List items animate in (staggered for many items)
  • Loading → content transition is smooth
  • Reduced motion preference respected
  • AnimationControllers properly disposed

Accessibility Integration

This skill focuses on visual/interaction design. For comprehensive accessibility:

  • Semantic labels: Use /a11y skill for Semantics widget patterns
  • Screen reader testing: See ../a11y/testing-guide.md
  • WCAG compliance: See ../a11y/SKILL.md for guidelines

Key accessibility requirements covered by design:

  • Touch targets ≥48dp (see interaction-guide.md)
  • Color contrast ≥4.5:1 (see visual-guide.md)
  • Reduced motion support (see animation-guide.md)

Related Skills

  • /a11y - Comprehensive accessibility (Semantics widgets, screen readers)
  • /feature-init - Initialize feature scaffold before polishing
  • /i18n - Localize user-facing text, error messages
  • /testing - Widget tests for UI interactions

Download now (ZIP)

  • Other versions192 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 192

    1. nextlevelbuilder/ui-ux-pro-max-skill★ 140ksame name
    2. Yeachan-Heo/oh-my-codex★ 34ksame name
    3. tokio-rs/toasty★ 3.2ksame name
    4. PaulWoitaschek/Voice★ 3.2ksame name
    5. joye61/pic-smaller★ 2.9ksame name
    6. oxsecurity/megalinter★ 2.6ksame name
    7. Infisical/agent-vault★ 2.4ksame name
    8. static-web-server/static-web-server★ 2.4ksame name
    9. SethGammon/Citadel★ 927same name
    10. Ohh-889/skyroc-admin★ 795same name

    182 more not listed

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • Used alongsideProjects with it also use banner-design, ui-styling and 10 more.

    Other files people use alongside this one.

    Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
    • lithStudySkill

      banner-design

      Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

      Also in 32 projects that use this

    • MicrosoftSkill

      ui-styling

      Guide for the visual style, structure, and shared building blocks used by Semantic Link Labs interactive UI tools (HTML widgets and anywidget-based widgets). Use this when adding a new interactive UI, modifying an existing one, or adding shared visual components.

      Also in 33 projects that use this

    • lithStudySkill

      brand

      Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

      Also in 37 projects that use this

    • mayankjain1815-commitsSkill

      infra-audit

      Reads docker-compose, env files, ORM configs, and connection strings to map current infrastructure. Flags missing layers (cache, queue, analytics) based on observed access patterns. Outputs a structured infrastructure manifest.

      Also in 3 projects that use this

    • JetBrainsSkill

      slides

      Create and edit presentation slide decks (`.pptx`) with PptxGenJS and render/validation utilities. Use when tasks involve building a new PowerPoint deck, recreating slides from screenshots/PDFs/reference decks, modifying slide content while preserving editable output, adding charts/diagrams/visuals, or diagnosing layout issues such as overflow, overlaps, and font substitution.

      Also in 36 projects that use this

    • henrikthome-archSkill

      infra

      Manage all infrastructure for the Volos school project — Render (API backend), Cloudflare (DNS + Pages frontend), PostgreSQL database, and GitHub Actions workflows.

      Also in 3 projects that use this

  • In this repository27 other files it gives its agents.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free