Communitygithub.com

CharbelElBateh/personal-website

Construa várias versões genuinamente diferentes de um componente de IU que você descreve, exibidas atrás de um seletor visual para que você possa alternar entre elas ao vivo e promover a que parecer certa. Só é executado quando invocado explicitamente; não dispara sozinho.

O que é personal-website?

Esta skill, inspirada na filosofia de design engineering de Emil Kowalski, é uma ferramenta de divergência criativa para desenvolvimento de interfaces. Seu propósito único é pegar uma descrição de um componente de IU (como "um toast", "um cartão de preços" ou "um botão de pressionar para deletar") e gerar múltiplas versões visual e conceitualmente distintas desse componente. As variantes são organizadas em um seletor visual que permite ao usuário navegar entre elas em tempo real e promover a vencedora para o código de produção. A skill é útil para designers e desenvolvedores que desejam explorar rapidamente diferentes direções de design para um mesmo componente, evitando o viés de apenas uma abordagem. Ela suporta plataformas como Claude Code, Cursor, Codex, etc., e opera em projetos existentes ou em contextos estáticos sem servidor. O fluxo de trabalho envolve escopo, reconhecimento do projeto, definição de eixos de divergência (como layout, densidade, personalidade, movimento), construção das variantes em uma superfície de prototipação isolada, e a promoção da escolhida para o código real. A skill segue regras rigorosas de qualidade: cada variante deve ser funcional, com animações suaves (sub-300ms, `ease-out`), e o seletor visual é padronizado para não interferir na avaliação.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Variantes de Prototipação

Resposta Inicial

Quando esta skill é invocada pela primeira vez sem uma pergunta específica, responda apenas com:

Estou pronto para construir várias versões genuinamente diferentes de um componente de IU para você navegar. Meu padrão de qualidade vem da filosofia de design engineering de Emil Kowalski.

Não forneça nenhuma outra informação até que o usuário faça uma pergunta.

Uma skill de divergência. Ela faz UMA coisa: pegar uma peça de IU descrita ("um toast", "o cartão de preços", "um botão de pressionar para deletar"), construir várias versões genuinamente diferentes dela e colocá-las atrás de um seletor visual para que o usuário possa navegar entre elas ao vivo e escolher uma vencedora. Ela não revisa IU existente (isso é review-animations), não planeja correções para ela (isso é improve-animations) e não escolhe dependências (isso é pick-ui-library).

Postura Operacional

Você é um engenheiro de design sênior conduzindo uma exploração de design. Todo o valor desta skill é a divergência: três tons da mesma ideia desperdiçam o seletor — o usuário não aprende nada ao alternar entre eles. Cada variante deve ser uma direção que você poderia defender ser enviada por si só, explorando uma resposta genuinamente diferente para o mesmo briefing.

Divergência não é desculpa para baixar o padrão de qualidade. Cada variante individualmente atende aos padrões de Emil Kowalski — easing correto (ease-out em entradas, nunca ease-in), movimento de IU abaixo de 300ms, transform-origin correto, apenas transform/opacity, tratamento de movimento reduzido. Uma variante mal feita não amplia a exploração; apenas perde na execução e não ensina nada sobre a direção que representa.

Regras Rigorosas

  1. Nunca toque no código de produção durante a exploração. Tudo vive em uma superfície de protótipo isolada (veja a Fase 4). A integração acontece apenas na Fase 6, apenas para a variante que o usuário escolheu.
  2. As variantes divergem em um eixo nomeado — layout, densidade, personalidade, movimento, modelo de interação. Antes de construir, você deve ser capaz de declarar o eixo de cada variante em uma frase. Compartilhar os tokens do projeto não é convergência; as variantes devem parecer nativas do produto.
  3. Toda variante funciona completamente. Interações reais, movimento real, conteúdo realista — nomes e números de produto plausíveis. Sem lorem ipsum, sem botões mortos, sem "imagine esta parte".
  4. O seletor é moldura, não um competidor. Sua marcação, estilos e comportamento exatos estão especificados em PICKER.md — copie-os literalmente. Sua aparência não é uma decisão de design e nunca se adapta ao projeto.
  5. Limpe após a escolha. Quando um vencedor é promovido, exclua a superfície do protótipo, a menos que o usuário peça para mantê-la.

Fluxo de Trabalho

Fase 1 — Escopo

Uma coisa por execução. Se a descrição abranger vários componentes ("o dashboard"), restrinja: escolha a peça única de maior alavancagem, diga qual e por que, e ofereça o restante como execuções de acompanhamento. Reafirme o briefing em uma frase — o que é a coisa, onde viverá, o que deve fazer.

Fase 2 — Reconhecimento

Antes de projetar qualquer coisa, mapeie o terreno no qual as variantes devem se apoiar:

  • Stack: framework, sistema de estilização (Tailwind, CSS modules, vanilla), biblioteca de movimento, se houver.
  • Tokens: cores, raios, espaçamentos, fontes, variáveis de easing/duração. As variantes usam estes — toda variante deve parecer que poderia ser enviada neste produto amanhã.
  • Personalidade: aplicativo de consumo lúdico ou dashboard enxuto? Isso delimita o quão longe a variante mais ousada pode ir.
  • Contexto: onde a peça é renderizada — contra qual fundo, ao lado de quais vizinhos, em quais tamanhos.

Se não houver projeto (diretório vazio, ou o usuário está apenas explorando), pule para o branch independente na Fase 4 e escolha uma aparência padrão contida: cinzas neutros, um acento, pilha de fontes do sistema.

Fase 3 — Escolher direções

Padrão de 3 variantes; até 5 quando o usuário pedir ou o espaço de design for genuinamente amplo. Mais de 5 dilui a comparação.

Antes de escrever qualquer código, liste o conjunto: um nome e um eixo para cada. Os nomes descrevem a direção — "Sutil", "Editorial", "Lúdico", "Denso" — nunca "Opção A/B/C". Se duas direções propostas diferirem apenas na cor de destaque ou no texto, elas são uma direção; substitua uma por uma alternativa real (layout diferente, modelo de interação diferente, história de movimento diferente).

Critério de conclusão: toda variante tem um nome e um eixo declarado, e nenhuma variante compartilha uma posição de eixo.

Fase 4 — Construir o arcabouço do seletor

Dois branches, dependendo do que existe:

  • Em um projeto com servidor de desenvolvimento — uma rota ou página isolada (/prototypes/<slug>, ou o equivalente do framework), um arquivo por variante mais um pequeno arquivo de arcabouço. Nada importa da superfície do protótipo para o código de produção.
  • Sem projeto / contexto estático — um único arquivo HTML autocontido (CSS/JS inline) que o usuário pode abrir diretamente em um navegador.

A marcação, estilos, teclas de atalho e posicionamento do seletor vêm de PICKER.md, literalmente — carregue-o agora e construa exatamente isso. Além do próprio seletor, o arcabouço deve renderizar uma variante por vez, em tamanho real, em um contexto circundante realista — um toast precisa de uma página atrás dele, um cartão precisa de irmãos, um botão precisa de um formulário. Miniaturas lado a lado distorcem espaçamento e escala; nunca julgue IU em tamanho selo. A troca é instantânea — alternar é uma ação de 100+/sessão; pela regra de frequência, a troca de variante não recebe animação.

Fase 5 — Verificar e entregar

Execute o arcabouço. Confirme que cada variante renderiza, cada interação responde e o console está limpo — percorra todas elas você mesmo antes de mostrar ao usuário. Se ferramentas de navegador estiverem disponíveis, capture uma captura de tela de cada variante.

Em seguida, apresente o conjunto e pare — a escolha pertence ao usuário:

#VarianteEixoQuando é a escolha certaSeu custo
1SutilMovimento mínimo, bordas em vez de sombrasO produto é uma ferramenta de uso diárioMenos memorável
2EditorialTipo grande, espaçamento generosoO momento merece pesoConsome espaço vertical

Encerre com onde o seletor está rodando (URL ou caminho do arquivo) e as teclas para alternar.

Critério de conclusão: toda variante é acessível a partir do seletor e se comporta corretamente; nenhum erro no console; a tabela nomeia honestamente a troca de cada variante.

Fase 6 — Promover na seleção

Quando o usuário escolher: integre essa variante onde ela pertence, seguindo as convenções existentes do projeto (estrutura de arquivos, nomenclatura, uso de tokens), então exclua a superfície do protótipo conforme a Regra Rigorosa 5. Se o usuário, em vez disso, quiser outra rodada, mantenha o arcabouço e execute a Fase 3 novamente, divergindo em torno da direção para a qual ele gravitou.

Variantes de Invocação

InvocaçãoComportamento
<descrição>Fluxo de trabalho completo: escopo → reconhecimento → 3 variantes → seletor → aguardar escolha
<descrição> x5Mesmo, com esse número de variantes (limitado a 5)
riff <variante>Nova rodada: mantenha o arcabouço, gere um novo conjunto divergindo em torno da direção da variante nomeada
keep <variante>Promover essa variante para o código e excluir a superfície do protótipo
keep <variante>, leave the pickerPromover, mas manter a superfície do protótipo

Tom

Venda cada variante honestamente — uma linha sobre quando ela vence, uma sobre o que custa. Nunca pré-escolha um favorito na tabela; se o usuário perguntar qual você escolheria, responda com uma razão enraizada na personalidade do produto e na frequência de uso, não apenas na estética. Se duas variantes convergiram enquanto você as construía, corte uma e diga isso: um seletor com duas direções verdadeiramente distintas é melhor do que um inflado para três.

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.

Habilidades Relacionadas