Communitygithub.com

deuriib/agent-skills - animate-ui

Gatilho: animate-ui, motion components, shadcn animado. Implemente e personalize componentes alimentados por Motion do Animate UI.

O que é agent-skills - animate-ui?

Esta skill permite que um agente de IA adicione e personalize componentes de UI animados usando a distribuição Animate UI em um projeto shadcn/ui. Ela fornece um contrato de ativação claro para identificar quando usá-la, regras rígidas para garantir consistência (como dependências necessárias e convenções de nomenclatura), e portões de decisão para orientar tarefas específicas (como adicionar primitivas ou componentes). A skill é útil para desenvolvedores que desejam implementar padrões Motion (Framer Motion) de forma eficiente, adotando uma abordagem de 'cópia-primeiro' para modificar o código abertamente. Ela suporta plataformas como React, Tailwind CSS e Framer Motion, e detalha etapas de execução que vão desde a verificação de pré-requisitos até o polimento de transições spring.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/deuriib/agent-skills/tree/HEAD/skills/animate-ui

Perguntar na sua IA favorita

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

Documentação

Skill: animate-ui

Contrato de Ativação

Use esta skill quando:

  • Adicionar ou personalizar componentes de UI animados usando a distribuição Animate UI.
  • Implementar padrões alimentados por Motion (Framer Motion) em um projeto shadcn/ui.
  • Configurar o registro Animate UI ou adicionar primitivas/componentes específicos.

Regras Rígidas

  • Abordagem de Cópia-Primeiro: Sempre trate os componentes como "código aberto" a ser copiado e modificado, não como importações fixas de biblioteca.
  • Verificação de Dependências: Garanta que motion, tailwind-merge, clsx e lucide-react estejam instalados antes de adicionar componentes.
  • Convenção de Nomenclatura: Siga o padrão @animate-ui/{categoria}-{subcategoria}-{nome} para comandos CLI do shadcn.
  • Caminhos de Importação: Use como padrão @/components/animate-ui/ para todos os componentes e primitivas adicionados.
  • Stack Padrão: Use React, Tailwind CSS e Framer Motion (Motion).

Portões de Decisão

TarefaAção
Novo ProjetoExecute npx shadcn@latest init e configure Tailwind/Motion.
Adicionar PrimitivaUse npx shadcn@latest add @animate-ui/primitivas-{categoria}-{nome}.
Adicionar ComponenteUse npx shadcn@latest add @animate-ui/componentes-{categoria}-{nome}.
Motion PersonalizadoEstenda componentes existentes usando props motion (ex.: whileHover, transition).

Etapas de Execução

  1. Verificar Pré-requisitos: Cheque se framer-motion (ou motion) e tailwind-merge estão em package.json.
  2. Configuração Inicial: Se ainda não foi feito, siga o processo de inicialização do shadcn/ui.
  3. Seleção de Componente: Identifique se você precisa de uma Primitiva (lógica + movimento básico) ou de um Componente (peça de UI estilizada).
  4. Instalação: Use o CLI do shadcn com os nomes de pacotes com escopo @animate-ui.
  5. Integração: Importe de @/components/animate-ui/... e passe as props necessárias.
  6. Polimento: Ajuste as transições spring (stiffness, damping) para combinar com a sensação do projeto.

Contrato de Saída

  • Lista de componentes adicionados via CLI do shadcn.
  • Caminhos de importação verificados na implementação.
  • Explicação de quaisquer ajustes de motion personalizados, se houver.

Referências

  • references/getting-started.md — Guia de instalação e configuração.
  • references/components.md — Categorias e convenções de nomenclatura.
  • references/motion-patterns.md — Configurações comuns de spring e transição.

Habilidades Relacionadas