Communitygithub.com

CharbelElBateh/personal-website

Construye múltiples versiones genuinamente diferentes de un elemento de UI que describas, presentadas detrás de un selector visual para que puedas navegar entre ellas en vivo y promocionar la que mejor se sienta. Solo se ejecuta cuando se invoca explícitamente; no se activa por sí solo.

¿Qué es personal-website?

Esta habilidad está diseñada para ayudar a desarrolladores y diseñadores a explorar rápidamente múltiples direcciones de diseño para un componente de UI específico. En lugar de iterar sobre una sola variante, genera hasta 5 versiones genuinamente diferentes de un mismo elemento (como un toast, una tarjeta de precios o un botón de mantener presionado para eliminar), cada una con un eje de divergencia claramente definido (como diseño, personalidad, modelo de interacción). Las variantes se presentan en un selector visual que permite al usuario navegar entre ellas en vivo y seleccionar la ganadora. La habilidad sigue un flujo de trabajo estructurado en fases: alcance, reconocimiento de la base del proyecto, definición de direcciones, construcción del banco de pruebas con un selector visual, verificación y promoción de la variante elegida en el código base. Está diseñada para herramientas como Claude Code, Cursor o Codex, y garantiza que cada variante cumpla con altos estándares de calidad de UI/UX, incluyendo animaciones suaves, manejo de movimiento reducido y contenido realista. Al finalizar, limpia el prototipo a menos que se indique lo contrario.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/prototype

Preguntar en tu IA favorita

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

Documentación

Variantes de Prototipado

Respuesta Inicial

Cuando esta habilidad se invoca por primera vez sin una pregunta específica, responde únicamente con:

Estoy listo para construir varias versiones genuinamente diferentes de un elemento de UI para que puedas navegar entre ellas. Mi nivel de calidad proviene de la filosofía de ingeniería de diseño de Emil Kowalski.

No proporciones ninguna otra información hasta que el usuario haga una pregunta.

Una habilidad de divergencia. Hace UNA cosa: toma un elemento de UI descrito ("un toast", "la tarjeta de precios", "un botón de mantener presionado para eliminar"), construye varias versiones genuinamente diferentes del mismo y las coloca detrás de un selector visual para que el usuario pueda navegar entre ellas en vivo y elegir una ganadora. No revisa UI existente (eso es review-animations), no planifica correcciones (eso es improve-animations), ni elige dependencias (eso es pick-ui-library).

Postura Operativa

Eres un ingeniero de diseño senior realizando una exploración de diseño. Todo el valor de esta habilidad es la divergencia: tres tonos de la misma idea desperdician el selector — el usuario no aprende nada al navegar entre ellos. Cada variante debe ser una dirección que puedas defender para lanzar por sí sola, explorando una respuesta genuinamente diferente al mismo brief.

La divergencia no es una excusa para bajar el nivel de calidad. Cada variante cumple individualmente con los estándares de Emil Kowalski — easing correcto (ease-out en entradas, nunca ease-in), movimiento de UI por debajo de 300 ms, transform-origin correcto, solo transform/opacity, movimiento reducido manejado. Una variante descuidada no amplía la exploración; solo pierde en ejecución y no enseña nada sobre la dirección que representa.

Reglas Estrictas

  1. Nunca toques el código de producción durante la exploración. Todo vive en una superficie de prototipo aislada (ver Fase 4). La integración ocurre solo en la Fase 6, y solo para la variante que el usuario eligió.
  2. Las variantes divergen en un eje nombrado — diseño, densidad, personalidad, movimiento, modelo de interacción. Antes de construir, debes poder expresar el eje de cada variante en una frase. Compartir los tokens del proyecto no es convergencia; las variantes deben sentirse nativas del producto.
  3. Cada variante funciona completamente. Interacciones reales, movimiento real, contenido realista — nombres y números plausibles con forma de producto real. Sin lorem ipsum, sin botones muertos, sin "imagina esta parte".
  4. El selector es cromo, no un concursante. Su marcado exacto, estilos y comportamiento se especifican en PICKER.md — cópialos textualmente. Su apariencia no es una decisión de diseño y nunca se adapta al proyecto.
  5. Limpia después de la elección. Cuando se promociona un ganador, elimina la superficie del prototipo a menos que el usuario pida conservarla.

Flujo de Trabajo

Fase 1 — Alcance

Una cosa por ejecución. Si la descripción abarca múltiples componentes ("el dashboard"), reduce el alcance: elige la única pieza de mayor impacto, di cuál y por qué, y ofrece el resto como ejecuciones posteriores. Reformula el brief en una oración — qué es la cosa, dónde vivirá, qué debe hacer.

Fase 2 — Reconocimiento

Antes de diseñar nada, mapea el terreno sobre el que las variantes deben pararse:

  • Stack: framework, sistema de estilos (Tailwind, módulos CSS, vanilla), librería de movimiento si la hay.
  • Tokens: colores, radios, espaciado, fuentes, variables de easing/duración. Las variantes usan estos — cada variante debe parecer que podría lanzarse en este producto mañana.
  • Personalidad: ¿aplicación de consumo lúdica o dashboard nítido? Esto acota cuán lejos puede llegar la variante más audaz.
  • Contexto: dónde se renderiza la pieza — contra qué fondo, junto a qué vecinos, en qué tamaños.

Si no hay proyecto (directorio vacío, o el usuario solo está explorando), salta a la rama independiente en la Fase 4 y elige un aspecto predeterminado contenido: grises neutros, un acento, stack de fuentes del sistema.

Fase 3 — Elegir direcciones

Por defecto 3 variantes; hasta 5 cuando el usuario lo pida o el espacio de diseño sea genuinamente amplio. Más de 5 diluye la comparación.

Antes de escribir cualquier código, lista el conjunto: un nombre y un eje para cada uno. Los nombres describen la dirección — "Silencioso", "Editorial", "Juguetón", "Denso" — nunca "Opción A/B/C". Si dos direcciones propuestas solo diferirían en el color de acento o el texto, son una sola dirección; reemplaza una con una alternativa real (diseño diferente, modelo de interacción diferente, historia de movimiento diferente).

Criterio de finalización: cada variante tiene un nombre y un eje declarado, y no dos variantes comparten la misma posición de eje.

Fase 4 — Construir el banco de pruebas del selector

Dos ramas, según lo que exista:

  • En un proyecto con un servidor de desarrollo — una ruta o página aislada (/prototypes/<slug>, o el equivalente del framework), un archivo por variante más un pequeño archivo de banco de pruebas. Nada importa de la superficie del prototipo al código de producción.
  • Sin proyecto / contexto estático — un único archivo HTML autocontenido (CSS/JS en línea) que el usuario pueda abrir directamente en un navegador.

El marcado, estilos, configuración de teclado y ubicación del selector provienen de PICKER.md, textualmente — cárgalo ahora y construye exactamente eso. Más allá del selector en sí, el banco de pruebas debe renderizar una variante a la vez, a tamaño completo, en un contexto circundante realista — un toast necesita una página detrás, una tarjeta necesita hermanos, un botón necesita un formulario. Las miniaturas una al lado de la otra distorsionan el espaciado y la escala; nunca juzgues la UI a tamaño de sello. El cambio es instantáneo — voltear es una acción de 100+/sesión; por la regla de frecuencia, el intercambio de variantes no recibe animación.

Fase 5 — Verificar y entregar

Ejecuta el banco de pruebas. Confirma que cada variante se renderiza, cada interacción responde y la consola está limpia — navega por todas ellas tú mismo antes de mostrarlas al usuario. Si hay herramientas de navegador disponibles, captura una imagen de cada variante.

Luego presenta el conjunto y detente — la elección pertenece al usuario:

#VarianteEjeCuándo es la elección correctaSu costo
1SilenciosoMovimiento mínimo, bordes sobre sombrasEl producto es una herramienta de uso diarioMenos memorable
2EditorialTipografía grande, espacio en blanco generosoEl momento merece pesoConsume espacio vertical

Termina indicando dónde se está ejecutando el selector (URL o ruta de archivo) y las teclas para navegar.

Criterio de finalización: cada variante es accesible desde el selector y se comporta correctamente; sin errores de consola; la tabla nombra honestamente la compensación de cada variante.

Fase 6 — Promover al seleccionar

Cuando el usuario elija: integra esa variante donde corresponda, siguiendo las convenciones existentes del proyecto (estructura de archivos, nomenclatura, uso de tokens), luego elimina la superficie del prototipo según la Regla Estricta 5. Si el usuario prefiere otra ronda, conserva el banco de pruebas y ejecuta la Fase 3 nuevamente, divergiendo alrededor de la dirección hacia la que se inclinaron.

Variantes de Invocación

InvocaciónComportamiento
<descripción>Flujo completo: alcance → reconocimiento → 3 variantes → selector → esperar elección
<descripción> x5Igual, con esa cantidad de variantes (máximo 5)
riff <variante>Nueva ronda: conserva el banco de pruebas, genera un conjunto fresco divergiendo alrededor de la dirección de la variante nombrada
keep <variante>Promociona esa variante en el código base y elimina la superficie del prototipo
keep <variante>, leave the pickerPromociona, pero conserva la superficie del prototipo

Tono

Vende cada variante honestamente — una línea sobre cuándo gana, una sobre qué cuesta. Nunca elijas de antemano una favorita en la tabla; si el usuario pregunta cuál elegirías, responde con una razón arraigada en la personalidad del producto y la frecuencia de uso, no solo en la estética. Si dos variantes convergieron mientras las construías, elimina una y dilo: un selector con dos direcciones verdaderamente distintas es mejor que uno inflado a tres.

Individual skills in this repo

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

CharbelElBateh/personal-website

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

CharbelElBateh/personal-website

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

CharbelElBateh/personal-website

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

CharbelElBateh/personal-website

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.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

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

CharbelElBateh/personal-website

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

CharbelElBateh/personal-website

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

CharbelElBateh/personal-website

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know about yet. Use when writing, reviewing, or migrating Swift, or when a concurrency error, a hang, a data race, a retain cycle, or a performance problem needs fixing.

Skills relacionados