Communitygithub.com

CharbelElBateh/personal-website

Elige la biblioteca adecuada para una tarea de frontend a partir de una lista seleccionada y con opinión fundamentada: números, campos OTP, gráficos, menú de comandos, virtualización, arrastrar y soltar, notificaciones, estado, estilos y más. Solo se ejecuta cuando se le invoca explícitamente; no se activa por sí sola.

¿Qué es personal-website?

Esta skill, basada en la lista curada de Emil Kowalski, ayuda a desarrolladores y agentes de IA a seleccionar la biblioteca de frontend más adecuada para una tarea específica, evitando la parálisis por elección y promoviendo decisiones consistentes en proyectos de React, Next.js y ecosistemas similares. Funciona en plataformas como Claude Code, Cursor y Codex, y se activa solo cuando el usuario la invoca con una pregunta concreta (por ejemplo, «necesito notificaciones»). La skill no sugiere opciones fuera de la lista a menos que la tarea no esté cubierta o el usuario lo solicite explícitamente. Para cada tarea recomienda una única biblioteca, justifica brevemente su elección y, si forma parte de la solicitud, indica cómo instalarla o integrarla. También identifica desajustes comunes (por ejemplo, animar números con texto en lugar de usar NumberFlow) para corregir malas prácticas de forma educativa.

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

Preguntar en tu IA favorita

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

Documentación

Elegir la biblioteca adecuada

Respuesta inicial

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

Estoy listo para elegir la biblioteca adecuada para tu tarea. Mis recomendaciones provienen de la lista curada de Emil Kowalski.

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

Es una skill de consulta. Cuando se invoca con una tarea ("necesito notificaciones", "¿qué debería usar para arrastrar y soltar?"), asocia la tarea con la lista curada que aparece a continuación y recomienda la biblioteca. Estas son selecciones deliberadas, basadas en el gusto personal; no sustituyas alternativas fuera de esta lista a menos que el usuario las solicite o que la tarea no esté cubierta realmente.

Cómo usarla

  1. Identifica la tarea, no la biblioteca que mencionó el usuario. "Necesito mostrar un menú desplegable" es una tarea de primitivas de UI (base-ui), incluso si el usuario preguntó por otra cosa.
  2. Verifica qué está ya instalado. Revisa primero el archivo package.json. Si el proyecto ya usa una biblioteca de la lista, úsala. Si usa un competidor (por ejemplo, react-window en lugar de Virtuoso), señala la recomendación pero no cambies la dependencia sin que te lo pidan.
  3. Recomienda una sola biblioteca, indica para qué sirve en una frase y, si forma parte de la solicitud, instálala o configúrala. No presentes un menú de opciones cuando la lista tiene una respuesta clara.
  4. Si la tarea no está cubierta por la lista, dilo explícitamente y recomienda basándote en tu propio conocimiento, pero deja claro que te has salido de la lista curada.

La lista

Componentes de UI y primitivas

TareaBiblioteca
Componentes de UI sin estilo y accesibles (diálogos, popovers, menús, selects…)base-ui
Menús de comandos (paletas ⌘K)cmdk
Notificaciones / avisosSonner
Campos de contraseña de un solo uso / código de verificacióninput-otp
Interfaces de control / paneles personalizablesLeva — dialkit es una alternativa

Movimiento y elementos visuales

TareaBiblioteca
Animación de propósito general (muelles, animaciones de diseño, entrada/salida)motion (Framer Motion)
Animación de números (contadores, precios, estadísticas)NumberFlow
Componentes de texto animadotorph
Globos 3DCobe
Imágenes OG dinámicas (HTML/CSS → SVG/PNG)Satori
Resaltado de sintaxisshiki

Recurre a motion cuando necesites muelles, animaciones de diseño, animaciones de salida o valores controlados por gestos. Un simple hover o fade no lo necesita; las transiciones CSS simples son la herramienta adecuada en esos casos.

Gráficos

TareaBiblioteca
Gráficos en tiempo real / streamingLiveline
Gráficos generales (estáticos o paneles interactivos)recharts

La división: si los puntos de datos llegan en vivo y el gráfico se desplaza con el tiempo, usa Liveline. Todo lo demás es recharts.

Interacción y rendimiento

TareaBiblioteca
Arrastrar y soltardnd kit
Virtualización (listas largas, tablas grandes)Virtuoso

Estado y estilos

TareaBiblioteca
Gestión de estadozustand
Construcción condicional de cadenas classNameclsx
Estilo type-safe basado en variantes para Tailwindcva
Cambio de tema / modo oscuro (sin parpadeo al cargar)next-themes

La división de estilos: clsx para clases condicionales ad-hoc; cva cuando un componente tiene variantes reales (tamaño, intención, estado) que merecen una API tipada. Se complementan: cva usa internamente entradas al estilo clsx.

Desajustes comunes a detectar

  • Notificaciones hechas a mano o con una biblioteca de modales → Sonner existe precisamente para esto.
  • Un menú desplegable/diálogo basado en <div> con gestión manual del foco → base-ui, que maneja accesibilidad, captura del foco y cierre.
  • Animar un número volviendo a renderizar texto → NumberFlow gestiona las transiciones de dígitos correctamente.
  • Renderizar una lista de más de 1000 filas directamente → Virtuoso antes de recurrir a trucos de paginación.
  • Un useState por componente con una red de props para estado compartido → zustand.
  • Ternarias de className con literales de plantilla a tres niveles de profundidad → clsx (o cva si tiene forma de variante).

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

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. 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