Communitygithub.com

xzedm/clipplic-landing

Implementa el sistema de UI Material Design 3 (Material You) de Google. Principal: Jetpack Compose Material3 (MaterialTheme, componentes, diseño adaptativo). También Flutter y web limitada (@material/web, modo mantenimiento). Cubre tokens, más de 30 componentes, diseño, tematización, M3 Expressive (matriz de plataformas) y accesibilidad. Úsalo cuando necesites: 'material design', 'MD3', 'material you', 'Jetpack Compose', 'MaterialTheme', 'material component', 'md3 button'.

¿Qué es clipplic-landing?

Este skill proporciona una guía completa para implementar Material Design 3 (MD3), el sistema de diseño personal, adaptativo y expresivo de Google. Se enfoca principalmente en Jetpack Compose para Android, utilizando la biblioteca `androidx.compose.material3` con `MaterialTheme`, componentes adaptativos y la integración de la API de colores dinámicos. También cubre la implementación en Flutter mediante `useMaterial3: true` y en la web de forma limitada con `@material/web`, que está en modo de mantenimiento. El skill incluye un sistema detallado de tokens de diseño (colores, tipografía, formas, elevación y movimiento), una referencia rápida de más de 30 componentes con sus variantes y asignaciones a elementos web (cuando existen), y un árbol de decisiones para ayudar a los desarrolladores a elegir el enfoque correcto según la plataforma y el tipo de interfaz. Además, incorpora las últimas actualizaciones de Google I/O 2026, que refuerzan el uso de Compose como ruta principal, el sistema de diseño expresivo, la rejilla de 8dp, y la expansión a wearables y XR. Es útil para cualquier desarrollador que desee crear interfaces modernas, consistentes y accesibles siguiendo los principios de MD3, ya sea en Android, Flutter o web.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/material-3

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Material Design 3

Este skill guía la implementación de Material Design 3 (MD3) de Google, un sistema de diseño personal, adaptativo y expresivo. MD3 utiliza color dinámico, superficies tonales, formas redondeadas y movimiento basado en resortes para crear interfaces que se sienten vivas y personales.

Filosofía

MD3 se basa en tres principios:

  • Personal: El color dinámico adapta la UI al fondo de pantalla o contenido del usuario. La tematización es individual, no universal.
  • Adaptativo: Los diseños se transforman en 5 clases de tamaño de ventana. Los componentes se redimensionan, reposicionan y cambian de factor de forma de manera responsiva.
  • Expresivo: La morfología de formas, la física de resortes y la tipografía enfatizada crean momentos de deleite sin sacrificar la usabilidad.

Actualizaciones recientes: Google I/O 2026

La actualización de Google I/O 2026 de Material refuerza una ruta Compose-first para Android y expande la guía expresiva/adaptativa:

  • Material Android es Compose-first: Para trabajos nuevos en Android, prefiere Jetpack Compose Material3 para obtener los últimos componentes, APIs expresivas, scaffolds adaptativos e integración con la API de Styles. Las Android Views pueden ser necesarias en aplicaciones existentes, pero no deben tratarse como la ruta predeterminada para nuevas implementaciones de Material 3.
  • Sistema de diseño expresivo: Utiliza un scaffold de diseño expresivo para adaptar pantallas a través de dispositivos móviles, escritorios, plegables, relojes, XR y otros factores de forma espaciales. Empieza desde scaffolds adaptativos/clases de tamaño de ventana en lugar de diseños fijos centrados en teléfonos.
  • Sistema de espaciado de 8dp: Aplica tokens de espaciado para márgenes, rellenos y espacios, de modo que los diseños y componentes puedan adaptarse programáticamente al tipo de dispositivo y densidad.
  • Componentes expresivos nuevos/actualizados: Las listas, menús, búsqueda y barras de aplicación de búsqueda tienen guías expresivas renovadas, con Jetpack Compose como objetivo de implementación principal.
  • Relojes y XR: Los relojes enfatizan el movimiento basado en física, texto en arco y contenedores ajustados al borde. XR enfatiza paneles espaciales y elevación basada en profundidad.

Diferencias clave con MD2:

  • Las superficies tonales reemplazan las sombras de elevación como la señal de profundidad principal
  • El color dinámico genera esquemas completos a partir de un solo color semilla
  • Esquinas completamente redondeadas por defecto (no ligeramente redondeadas)
  • La física de movimiento basada en resortes reemplaza las curvas de easing fijas para componentes
  • 3 niveles de contraste controlados por el usuario (estándar/medio/alto)

Relación con el skill de frontend-design: Cuando ambos skills están activos, MD3 proporciona el sistema de diseño (tokens, componentes, reglas de diseño) y frontend-design proporciona dirección creativa dentro de esas restricciones. Las reglas de MD3 tienen prioridad para la estructura de componentes y el uso de tokens. Nota: Roboto/Roboto Flex ES la tipografía predeterminada correcta en MD3; la guía de frontend-design para evitar Roboto no aplica al implementar MD3.

Árbol de decisión

¿Qué estás construyendo?

Scaffold completo de aplicación  → Ver "Patrones comunes: App Shell" + referencias/layout-and-responsive.md
Componente único                → Ver "Referencia rápida de componentes" → referencias/component-catalog.md
Tema personalizado              → Ver referencias/theming-and-dynamic-color.md
Formulario / diseño de entrada  → Ver referencias/component-catalog.md § Componentes de entrada
Estructura de navegación        → Ver referencias/navigation-patterns.md
Visualización de datos          → Ver referencias/component-catalog.md § Visualización de datos

¿Qué plataforma?

Jetpack Compose          → Principal: androidx.compose.material3, MaterialTheme, referencias/*
Flutter                  → useMaterial3: true en ThemeData, ColorScheme.fromSeed()
Web (JavaScript vanilla) → @material/web (limitado; modo mantenimiento) + propiedades personalizadas CSS
Web (React/Vue/Svelte)   → Propiedades personalizadas CSS + componentes envolventes (sin librería oficial de React)
Web (solo CSS)           → Valores de tokens MD3 como propiedades personalizadas CSS (sin elementos <md-*>)

Sistema de tokens de diseño

Todos los tokens de MD3 usan el espacio de nombres md.sys. Jetpack Compose mapea roles a MaterialTheme.colorScheme, MaterialTheme.typography y MaterialTheme.shapes (mismos roles semánticos que la especificación). En la web, estos se mapean a propiedades personalizadas CSS (--md-sys-*):

Tokens de color (--md-sys-color-*)

TokenPropósito
primaryRellenos de alta énfasis, texto, iconos sobre superficie
on-primaryTexto/iconos sobre primary
primary-containerRelleno destacado para componentes clave (FAB, etc.)
on-primary-containerTexto/iconos sobre primary-container
secondary / on-secondaryAcentos menos prominentes
secondary-container / on-secondary-containerComponentes recesivos (botones tonales)
tertiary / on-tertiaryAcentos contrastantes
tertiary-container / on-tertiary-containerContenedores complementarios
error / on-errorEstados de error (estáticos — no cambian con color dinámico)
error-container / on-error-containerRellenos de contenedor de error
surfaceFondo predeterminado
on-surfaceTexto/iconos sobre cualquier superficie
on-surface-variantTexto/iconos de menor énfasis sobre superficie
surface-container-lowestContenedor de menor énfasis
surface-container-lowContenedor de énfasis bajo
surface-containerContenedor predeterminado (áreas de navegación)
surface-container-highContenedor de énfasis alto
surface-container-highestContenedor de énfasis más alto
surface-dim / surface-brightMantienen brillo relativo entre claro/oscuro
inverse-surface / inverse-on-surface / inverse-primaryElementos contrastantes (snackbars)
outlineLímites importantes (bordes de campos de texto)
outline-variantElementos decorativos (divisores)

Detalles completos: references/color-system.md

Tokens de tipografía (--md-sys-typescale-*)

EscalaTamañosUso
DisplayL / M / STexto heroico, números grandes
HeadlineL / M / SEncabezados de sección
TitleL / M / SEncabezados más pequeños, títulos de tarjetas
BodyL / M / STexto de párrafo, descripciones
LabelL / M / SBotones, chips, subtítulos

Cada estilo tiene tokens para: -font, -weight, -size, -line-height, -tracking Además, 15 variantes enfatizadas (peso mayor) mediante --md-sys-typescale-emphasized-*

Detalles completos: references/typography-and-shape.md

Tokens de forma (--md-sys-shape-corner-*)

TokenValorComponentes de ejemplo
none0dp—
extra-small4dpChips, snackbars
small8dpCampos de texto, menús
medium12dpTarjetas
large16dpFABs, panel de navegación
large-increased20dp(Expresivo)
extra-large28dpDiálogos, hojas inferiores
extra-large-increased32dp(Expresivo)
extra-extra-large48dp(Expresivo)
full9999pxBotones, chips, insignias

Niveles de elevación

NivelDPDesplazamiento tonalUso
00dpNingunoSuperficies planas, la mayoría de componentes en reposo
11dp+5% primaryTarjetas elevadas, hojas modales
23dp+8% primaryMenús, barra de navegación, barra de aplicación desplazada
36dp+11% primaryFAB, diálogos, búsqueda, selectores de fecha/hora
48dp+12% primary(solo aumento al pasar el ratón/enfocar)
512dp+14% primary(solo aumento al pasar el ratón/enfocar)

La elevación en MD3 se comunica a través del color de superficie tonal, no sombras. Las sombras solo se usan cuando se necesita protección adicional contra fondos recargados.

Movimiento

MD3 Expressive (mayo 2025) introdujo física de movimiento basada en resortes para componentes. El sistema heredado de easing/duración todavía se usa para transiciones (entrada/salida/eje compartido):

EasingDuraciónTipo de transición
Enfatizado500msComienza y termina en pantalla
Enfatizado desacelerado400msEntrada a la pantalla
Enfatizado acelerado200msSalida de la pantalla
Estándar300msComienza y termina en pantalla (utilidad)
Estándar desacelerado250msEntrada a pantalla (utilidad)
Estándar acelerado200msSalida de pantalla (utilidad)

Valores CSS de easing:

  • Enfatizado: cubic-bezier(0.2, 0, 0, 1)
  • Enfatizado desacelerado: cubic-bezier(0.05, 0.7, 0.1, 1)
  • Enfatizado acelerado: cubic-bezier(0.3, 0, 0.8, 0.15)
  • Estándar: cubic-bezier(0.2, 0, 0, 1)
  • Estándar desacelerado: cubic-bezier(0, 0, 0, 1)
  • Estándar acelerado: cubic-bezier(0.3, 0, 1, 1)

Referencia rápida de componentes

ComponenteElemento WebVariantes claveCategoría
Botónmd-filled-button, md-outlined-button, md-text-button, md-elevated-button, md-filled-tonal-buttonRelleno, Contorneado, Texto, Elevado, Tonal; 5 tamaños (XS–XL); toggleAcciones
Grupo de botonesmd-button-groupEstándar, conectadoAcciones
FAB extendidomd-extended-fabSuperficie, Primario, Secundario, TerciarioAcciones
FABmd-fabPequeño, Mediano, GrandeAcciones
Menú FAB——Acciones
Botón de iconomd-icon-button, md-filled-icon-button, md-filled-tonal-icon-button, md-outlined-icon-buttonEstándar, Relleno, Relleno Tonal, ContorneadoAcciones
Botón segmentado—Selección única, Selección múltipleAcciones
Botón dividido——Acciones
Insignia—Pequeña (punto), Grande (conteo)Comunicación
Indicador de carga—Lineal, CircularComunicación
Indicador de progresomd-linear-progress, md-circular-progressLineal, Circular; determinista/indeterministaComunicación
Snackbar—Una línea, Dos líneas, AcciónComunicación
Tooltip—Simple, EnriquecidoComunicación
Tarjeta—Rellena, Contorneada, ElevadaContención
Carrusel—Multinavegación, Sin contenedor, HeroicoContención
Diálogomd-dialogBásico, Pantalla completaContención
Hoja inferior—Estándar, ModalHojas
Hoja lateral—Estándar, ModalHojas
Divisormd-dividerAncho completo, InsertadoContención
Casilla de verificaciónmd-checkbox—Entrada
Chipsmd-chip-set, md-assist-chip, md-filter-chip, md-input-chip, md-suggestion-chipAsistencia, Filtro, Entrada, SugerenciaEntrada
Selector de fecha—Acoplado, Modal, RangoEntrada
Menúmd-menu, md-menu-item—Entrada
Botón de opciónmd-radio—Entrada
Deslizadormd-sliderContinuo, Discreto, RangoEntrada
Interruptormd-switchCon/sin iconoEntrada
Campo de textomd-filled-text-field, md-outlined-text-fieldRelleno, ContorneadoEntrada
Selector de hora—Acoplado, ModalEntrada
Barra de aplicación (superior)—Centrada, Pequeña, Mediana, GrandeNavegación
Barra de navegaciónmd-navigation-bar—Navegación
Panel de navegaciónmd-navigation-drawerEstándar, ModalNavegación
Riel de navegación——Navegación
Búsqueda—Barra de búsqueda, Vista de búsquedaNavegación
Pestañasmd-tabs, md-primary-tab, md-secondary-tabPrimaria, SecundariaNavegación
Barra de herramientas——Navegación
Listamd-list, md-list-itemUna línea, Dos líneas, Tres líneasVisualización de datos

Nota: Los componentes marcados con — para elemento web no tienen implementaciones en @material/web todavía. Usa propiedades personalizadas CSS con HTML estándar para estos. Los mapeos y ejemplos de Compose se encuentran en references/component-catalog.md.

Detalles completos de componentes con ejemplos de código: references/component-catalog.md

Jetpack Compose (principal)

Usa androidx.compose.material3 con MaterialTheme y composables de Material 3 (Scaffold, Button, NavigationBar, barras de aplicación superiores, etc.).

  • Tematización: MaterialTheme(colorScheme = …, typography = …, shapes = …). Prefiere dynamicLightColorScheme / dynamicDarkColorScheme en Android 12+ (API 31+) cuando se desee color dinámico; de lo contrario, lightColorScheme / darkColorScheme o código de tema generado desde Material Theme Builder.
  • UI adaptativa: Clases de tamaño de ventana, diseños de lista-detalle y panel de soporte, plegables — consulta references/layout-and-responsive.md y references/navigation-patterns.md.
  • Edge-to-edge e insets: Coloca el contenido con WindowInsets / relleno de scaffold para que las barras y el IME se comporten correctamente — consulta references/layout-and-responsive.md.
  • APIs experimentales: Algunas APIs de Material 3 requieren @OptIn(ExperimentalMaterial3Api::class) o opt-ins expresivos; asegúrate de que coincidan con tu BOM y compilador.
MaterialTheme(
    colorScheme = colorScheme, // de dynamicLightColorScheme / lightColorScheme / etc.
    typography = Typography(),
    shapes = Shapes(),
) {
    // Contenido M3 — prefiere referencias para Scaffold, navegación, campos de texto
}

Web (limitado): @material/web

Importante: Según Material Design 3 para Web, los Material Web Components están en modo de mantenimiento y M3 Expressive no está implementado en Web. Usa @material/web para UIs basadas en tokens cuando sea apropiado, pero no lo trates como equivalente a Compose para las funciones expresivas actuales.

Configuración

npm install @material/web

Importar componentes individualmente

Siempre importa solo los componentes que usas — importar todo el paquete infla el bundle:

// Bien — importaciones individuales
import '@material/web/button/filled-button.js';
import '@material/web/button/outlined-button.js';
import '@material/web/textfield/outlined-text-field.js';
import '@material/web/icon/icon.js';

// Mal — nunca hagas esto
import '@material/web'; // importa todo

Uso básico

<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <link href="https://fonts.googleapis.com/css2?family=Roboto+Flex:wght@400;500;700&display=swap" rel="stylesheet">
  <link href="https://fonts.googleapis.com/icon?family=Material+Symbols+Outlined" rel="stylesheet">
</head>
<body>
  <md-filled-button>Comenzar</md-filled-button>
  <md-outlined-text-field label="Correo electrónico" type="email"></md-outlined-text-field>

  <script type="module">
    import '@material/web/button/filled-button.js';
    import '@material/web/textfield/outlined-text-field.js';
  </script>
</body>
</html>

…

[truncado para traducción]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

xzedm/clipplic-landing

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

xzedm/clipplic-landing

Material Design 3 and Android platform guidelines. Use when building Android apps with Jetpack Compose or XML layouts, implementing Material You, navigation, or accessibility. Triggers on tasks involving Android UI, Compose components, dynamic color, or Material Design compliance.

xzedm/clipplic-landing

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

xzedm/clipplic-landing

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.

xzedm/clipplic-landing

Redesign mobile app UI to feel unmistakably Apple-like, iOS-forward, and native. Use this skill when building iOS apps, applying Apple Human Interface Guidelines, or creating native-feeling mobile interfaces with SF Pro typography, translucency, and system-like components.

xzedm/clipplic-landing

Accessibility engineering for product interfaces, from focus states and keyboard support to ARIA, forms, and screen readers. Use when building or reviewing UI components, modals, menus, forms, custom widgets, or when the user says "make this accessible" or reports keyboard or screen-reader issues. Triggers on accessibility, a11y, WCAG, aria, focus ring, focus-visible, focus trap, keyboard navigation, tab order, tabindex, screen reader, sr-only, aria-live, alt text, hit area, touch target, prefers-reduced-motion, autoplay, toast duration, skip link, semantic HTML, aria-label, form errors, disabled buttons, "not keyboard accessible".

xzedm/clipplic-landing

OKLCH color space and color usage for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, theme with Tailwind v4, and apply color with meaning. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, semantic color tokens, hue drift, chroma, dark mode colors, accent color, color meaning, light and dark appearance, increased contrast.

xzedm/clipplic-landing

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

xzedm/clipplic-landing

Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.

xzedm/clipplic-landing

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.

xzedm/clipplic-landing

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

xzedm/clipplic-landing

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

xzedm/clipplic-landing

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

xzedm/clipplic-landing

Extract design primitives from a public website and generate starter token files for your project.

xzedm/clipplic-landing

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code', 'convert this modal/dialog/drawer/panel to Figma'. This is the preferred workflow skill whenever the user wants to build or update a full page, modal, dialog, drawer, sidebar, panel, or any composed multi-section view in Figma from code or a description. Discovers design system components, variables, and styles from Code Connect files, existing screens, and library search, then imports them and assembles views incrementally section-by-section using design system tokens instead of hardcoded values.

xzedm/clipplic-landing

**MANDATORY prerequisite**: you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context, e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

xzedm/clipplic-landing

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

xzedm/clipplic-landing

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications.

xzedm/clipplic-landing

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

xzedm/clipplic-landing

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

Skills relacionados