Communitygithub.com

Habilidade de Estilização de UI

Crie interfaces de usuário bonitas e acessíveis com componentes shadcn/ui (baseados em Radix UI + Tailwind), estilização utilitária do Tailwind CSS e designs visuais baseados em canvas.

O que é Habilidade de Estilização de UI?

Esta habilidade fornece um conjunto abrangente de diretrizes e referências para construir interfaces de usuário modernas, acessíveis e visualmente impressionantes. Ela combina três camadas principais: componentes shadcn/ui (prontos e acessíveis, construídos sobre Radix UI), estilização utilitária com Tailwind CSS (para design responsivo e consistente) e um sistema de design visual baseado em canvas (para composições sofisticadas). É ideal para desenvolvedores que trabalham com React (Next.js, Vite, Remix, Astro) e desejam acelerar o desenvolvimento de UI, implementar dark mode, customizar temas e criar layouts responsivos. A habilidade inclui guias de componentes, padrões de acessibilidade, utilitários Tailwind, personalização de temas e scripts de automação em Python. O conhecimento é organizado em referências modulares, facilitando a consulta rápida durante o desenvolvimento.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmnhutwork/Landingpage-Photo-Retouch/tree/HEAD/.agents/skills/ui-styling

Perguntar na sua IA favorita

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

Documentação

O que Habilidade de Estilização de UI faz?

Habilidade abrangente para criar interfaces de usuário bonitas e acessíveis, combinando componentes shadcn/ui, estilização utilitária do Tailwind CSS e sistemas de design visual baseados em canvas.

Referência

Quando Usar Esta Habilidade

Use quando:

  • Construindo UI com frameworks baseados em React (Next.js, Vite, Remix, Astro)
  • Implementando componentes acessíveis (diálogos, formulários, tabelas, navegação)
  • Estilizando com abordagem CSS utilitária
  • Criando layouts responsivos e mobile-first
  • Implementando modo escuro e personalização de temas
  • Construindo sistemas de design com tokens consistentes
  • Gerando designs visuais, pôsteres ou materiais de marca
  • Prototipando rapidamente com feedback visual imediato
  • Adicionando padrões de UI complexos (tabelas de dados, gráficos, paletas de comando)

Stack Principal

Camada de Componentes: shadcn/ui

  • Componentes acessíveis pré-construídos via primitivas Radix UI
  • Modelo de distribuição copie-e-cole (componentes vivem no seu código)
  • TypeScript-first com segurança de tipos completa
  • Primitivas combináveis para UIs complexas
  • Instalação e gerenciamento baseados em CLI

Camada de Estilização: Tailwind CSS

  • Framework CSS utilitário
  • Processamento em tempo de build com zero overhead em runtime
  • Design responsivo mobile-first
  • Tokens de design consistentes (cores, espaçamento, tipografia)
  • Eliminação automática de código morto

Camada de Design Visual: Canvas

  • Composições visuais com qualidade de museu
  • Abordagem de design orientada por filosofia
  • Comunicação visual sofisticada
  • Mínimo de texto, máximo impacto visual
  • Padrões sistemáticos e estética refinada

Início Rápido

Configuração de Componentes + Estilização

Instale shadcn/ui com Tailwind:

npx shadcn@latest init

O CLI pergunta sobre framework, TypeScript, caminhos e preferências de tema. Isso configura tanto shadcn/ui quanto Tailwind CSS.

Adicione componentes:

npx shadcn@latest add button card dialog form

Use componentes com estilização utilitária:

import { Button } from "@/components/ui/button"
import { Card, CardHeader, CardTitle, CardContent } from "@/components/ui/card"

export function Dashboard() {
  return (
    <div className="container mx-auto p-6 grid gap-6 md:grid-cols-2 lg:grid-cols-3">
      <Card className="hover:shadow-lg transition-shadow">
        <CardHeader>
          <CardTitle className="text-2xl font-bold">Analytics</CardTitle>
        </CardHeader>
        <CardContent className="space-y-4">
          <p className="text-muted-foreground">Veja suas métricas</p>
          <Button variant="default" className="w-full">
            Ver Detalhes
          </Button>
        </CardContent>
      </Card>
    </div>
  )
}

Alternativa: Configuração Somente Tailwind

Projetos Vite:

npm install -D tailwindcss @tailwindcss/vite
// vite.config.ts
import tailwindcss from '@tailwindcss/vite'
export default { plugins: [tailwindcss()] }
/* src/index.css */
@import "tailwindcss";

Guia da Biblioteca de Componentes

Catálogo abrangente de componentes com padrões de uso, instalação e exemplos de composição.

Veja: references/shadcn-components.md

Abrange:

  • Componentes de formulário e entrada (Button, Input, Select, Checkbox, Date Picker, validação de formulário)
  • Layout e navegação (Card, Tabs, Accordion, Navigation Menu)
  • Sobreposições e diálogos (Dialog, Drawer, Popover, Toast, Command)
  • Feedback e status (Alert, Progress, Skeleton)
  • Componentes de exibição (Table, Data Table, Avatar, Badge)

Tema e Personalização

Configuração de tema, variáveis CSS, implementação de modo escuro e personalização de componentes.

Veja: references/shadcn-theming.md

Abrange:

  • Configuração de modo escuro com next-themes
  • Sistema de variáveis CSS
  • Personalização de cores e paletas
  • Personalização de variantes de componentes
  • Implementação de alternador de tema

Padrões de Acessibilidade

Padrões ARIA, navegação por teclado, suporte a leitores de tela e uso de componentes acessíveis.

Veja: references/shadcn-accessibility.md

Abrange:

  • Recursos de acessibilidade do Radix UI
  • Padrões de navegação por teclado
  • Gerenciamento de foco
  • Anúncios do leitor de tela
  • Acessibilidade na validação de formulários

Utilitários Tailwind

Classes utilitárias principais para layout, espaçamento, tipografia, cores, bordas e sombras.

Veja: references/tailwind-utilities.md

Abrange:

  • Utilitários de layout (Flexbox, Grid, posicionamento)
  • Sistema de espaçamento (padding, margin, gap)
  • Tipografia (tamanhos de fonte, pesos, alinhamento, altura da linha)
  • Cores e fundos
  • Bordas e sombras
  • Valores arbitrários para estilização personalizada

Design Responsivo

Breakpoints mobile-first, utilitários responsivos e layouts adaptativos.

Veja: references/tailwind-responsive.md

Abrange:

  • Abordagem mobile-first
  • Sistema de breakpoints (sm, md, lg, xl, 2xl)
  • Padrões de utilitários responsivos
  • Consultas de contêiner
  • Consultas de largura máxima
  • Breakpoints personalizados

Personalização do Tailwind

Estrutura do arquivo de configuração, utilitários personalizados, plugins e extensões de tema.

Veja: references/tailwind-customization.md

Abrange:

  • Diretiva @theme para tokens personalizados
  • Cores e fontes personalizadas
  • Extensões de espaçamento e breakpoints
  • Criação de utilitários personalizados
  • Variantes personalizadas
  • Organização de camadas (@layer base, components, utilities)
  • Diretiva apply para extração de componentes

Sistema de Design Visual

Filosofia de design baseada em canvas, princípios de comunicação visual e composições sofisticadas.

Veja: references/canvas-design-system.md

Abrange:

  • Abordagem da filosofia de design
  • Comunicação visual em vez de texto
  • Padrões sistemáticos e composição
  • Design de cor, forma e espaço
  • Integração de texto mínima
  • Execução com qualidade de museu
  • Sistemas de design com múltiplas páginas

Scripts Utilitários

Automação em Python para instalação de componentes e geração de configuração.

shadcn_add.py

Adicione componentes shadcn/ui com gerenciamento de dependências:

python scripts/shadcn_add.py button card dialog

tailwind_config_gen.py

Gere tailwind.config.js com tema personalizado:

python scripts/tailwind_config_gen.py --colors brand:blue --fonts display:Inter

Melhores Práticas

  1. Composição de Componentes: Construa UIs complexas a partir de primitivas simples e combináveis
  2. Estilização Utilitária: Use classes Tailwind diretamente; extraia componentes apenas para verdadeira repetição
  3. Responsivo Mobile-First: Comece com estilos mobile, adicione variantes responsivas
  4. Acessibilidade Primeiro: Aproveite as primitivas Radix UI, adicione estados de foco, use HTML semântico
  5. Tokens de Design: Use escala de espaçamento consistente, paletas de cores, sistema tipográfico
  6. Consistência do Modo Escuro: Aplique variantes escuras a todos os elementos temáticos
  7. Desempenho: Aproveite a eliminação automática de CSS, evite nomes de classe dinâmicos
  8. TypeScript: Use segurança de tipos completa para melhor DX
  9. Hierarquia Visual: Deixe a composição guiar a atenção, use espaçamento e cor intencionalmente
  10. Artesanato Especializado: Cada detalhe importa - trate UI como um ofício

Navegação nas Referências

Biblioteca de Componentes

  • references/shadcn-components.md - Catálogo completo de componentes
  • references/shadcn-theming.md - Tema e personalização
  • references/shadcn-accessibility.md - Padrões de acessibilidade

Sistema de Estilização

  • references/tailwind-utilities.md - Classes utilitárias principais
  • references/tailwind-responsive.md - Design responsivo
  • references/tailwind-customization.md - Configuração e extensões

Design Visual

  • references/canvas-design-system.md - Filosofia de design e fluxos de canvas

Automação

  • scripts/shadcn_add.py - Instalação de componentes
  • scripts/tailwind_config_gen.py - Geração de configuração

Padrões Comuns

Formulário com validação:

import { useForm } from "react-hook-form"
import { zodResolver } from "@hookform/resolvers/zod"
import * as z from "zod"
import { Form, FormField, FormItem, FormLabel, FormControl, FormMessage } from "@/components/ui/form"
import { Input } from "@/components/ui/input"
import { Button } from "@/components/ui/button"

const schema = z.object({
  email: z.string().email(),
  password: z.string().min(8)
})

export function LoginForm() {
  const form = useForm({
    resolver: zodResolver(schema),
    defaultValues: { email: "", password: "" }
  })

  return (
    <Form {...form}>
      <form onSubmit={form.handleSubmit(console.log)} className="space-y-6">
        <FormField control={form.control} name="email" render={({ field }) => (
          <FormItem>
            <FormLabel>Email</FormLabel>
            <FormControl>
              <Input type="email" {...field} />
            </FormControl>
            <FormMessage />
          </FormItem>
        )} />
        <Button type="submit" className="w-full">Entrar</Button>
      </form>
    </Form>
  )
}

Layout responsivo com modo escuro:

<div className="min-h-screen bg-white dark:bg-gray-900">
  <div className="container mx-auto px-4 py-8">
    <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
      <Card className="bg-white dark:bg-gray-800 border-gray-200 dark:border-gray-700">
        <CardContent className="p-6">
          <h3 className="text-xl font-semibold text-gray-900 dark:text-white">
            Conteúdo
          </h3>
        </CardContent>
      </Card>
    </div>
  </div>
</div>

Recursos

Individual skills in this repo

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

tmnhutwork/Landingpage-Photo-Retouch

Run a WCAG 2.1 AA accessibility audit on a design or page. Trigger with "audit accessibility", "check a11y", "is this accessible?", or when reviewing a design for color contrast, keyboard navigation, touch target size, or screen reader behavior before handoff.

tmnhutwork/Landingpage-Photo-Retouch

Get structured design feedback on usability, hierarchy, and consistency. Trigger with "review this design", "critique this mockup", "what do you think of this screen?", or when sharing a Figma link or screenshot for feedback at any stage from exploration to final polish.

tmnhutwork/Landingpage-Photo-Retouch

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.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

tmnhutwork/Landingpage-Photo-Retouch

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

tmnhutwork/Landingpage-Photo-Retouch

Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text.

tmnhutwork/Landingpage-Photo-Retouch

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

tmnhutwork/Landingpage-Photo-Retouch

Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

tmnhutwork/Landingpage-Photo-Retouch

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions "implement design", "generate code", "implement component", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.

tmnhutwork/Landingpage-Photo-Retouch

Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.

tmnhutwork/Landingpage-Photo-Retouch

Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.

tmnhutwork/Landingpage-Photo-Retouch

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

Habilidades Relacionadas