Communitygithub.com

ulasalyesil/personal-website-v2

Construa componentes de UI React modernos, componíveis e acessíveis, seguindo a especificação components.build.

O que é personal-website-v2?

Este skill define um conjunto abrangente de diretrizes para construir componentes de UI React modernos, focando em composição, acessibilidade e personalização. Ele é baseado na especificação components.build, co-criada por Hayden Bleasel e shadcn, e adaptada como um skill de IA. O skill organiza 16 categorias de regras, desde princípios fundamentais até distribuição, abrangendo tópicos como criação de APIs de componentes, gerenciamento de estado controlado/não controlado, suporte a acessibilidade (teclado, ARIA, foco), uso de Tailwind CSS e CVA para estilização, e publicação em registros ou npm. É acionado automaticamente ao criar, revisar ou refatorar componentes, design systems ou qualquer UI reutilizável, garantindo que o código gerado siga padrões modernos e boas práticas da comunidade React.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/components-build

Perguntar na sua IA favorita

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

Documentação

Especificação Components.build

Diretrizes abrangentes para construir componentes de UI modernos, componíveis e acessíveis. Contém 16 categorias de regras cobrindo desde princípios fundamentais até distribuição, coautorado por Hayden Bleasel e shadcn.

Quando Aplicar

Consulte estas diretrizes quando:

  • Criando novos componentes React ou bibliotecas de componentes
  • Projetando APIs de componentes e interfaces de props
  • Implementando recursos de acessibilidade (teclado, ARIA, gerenciamento de foco)
  • Construindo arquiteturas de componentes componíveis
  • Estilizando componentes com Tailwind CSS e CVA
  • Publicando componentes em registros ou npm

Categorias de Regras por Prioridade

PrioridadeCategoriaFocoPrefixo
1Visão GeralEscopo e objetivos da especificaçãooverview
2PrincípiosFilosofia central de designprinciples
3DefiniçõesTerminologia comumdefinitions
4ComposiçãoDecompondo componentes complexoscomposition
5AcessibilidadeTeclado, leitores de tela, ARIAaccessibility
6EstadoPadrões controlado/não controladostate
7TiposProps e interfaces TypeScripttypes
8PolimorfismoTroca de elemento com prop aspolymorphism
9As-ChildPadrão de composição Radix Slotas-child
10Atributos de Dadosdata-state e data-slotdata-attributes
11EstilizaçãoTailwind CSS, utilitário cn, CVAstyling
12Design TokensVariáveis CSS e temasdesign-tokens
13DocumentaçãoDocumentação de componentesdocumentation
14RegistroRegistros de componentesregistry
15NPMPublicação no npmnpm
16MarketplacesMercados de componentesmarketplaces

Referência Rápida

1. Visão Geral

  • overview - Escopo, objetivos e filosofia da especificação

2. Princípios

  • principles - Composibilidade, acessibilidade, customização, transparência

3. Definições

  • definitions - Terminologia comum (primitivo, composto, headless, etc.)

4. Composição

  • composition-root - Componente raiz com Context para estado compartilhado
  • composition-item - Componentes wrapper de item
  • composition-trigger - Componentes de gatilho interativos
  • composition-content - Componentes de exibição de conteúdo
  • composition-export - Padrão de exportação por namespace

5. Acessibilidade

  • accessibility-semantic-html - Use elementos HTML apropriados
  • accessibility-keyboard - Suporte completo de navegação por teclado
  • accessibility-aria - Roles, estados e propriedades ARIA corretos
  • accessibility-focus - Gerenciamento e restauração de foco
  • accessibility-live-regions - Anúncios para leitores de tela
  • accessibility-contrast - Requisitos de contraste de cor

6. Estado

  • state-uncontrolled - Gerenciamento de estado interno
  • state-controlled - Delegação de estado externo
  • state-controllable - Suporte a ambos os padrões com useControllableState

7. Tipos

  • types-extend-html - Estenda atributos HTML nativos
  • types-export - Exporte tipos de props para consumidores
  • types-single-element - Um componente envolve um elemento

8. Polimorfismo

  • polymorphism-as-prop - Altere o tipo do elemento renderizado
  • polymorphism-typescript - Componentes polimórficos com segurança de tipo
  • polymorphism-defaults - Padrões semânticos de elementos

9. As-Child

  • as-child-slot - Radix Slot para mesclagem de props
  • as-child-composition - Componha com componentes filhos

10. Atributos de Dados

  • data-attributes-state - Use data-state para estilizar estados
  • data-attributes-slot - Use data-slot para segmentar subcomponentes

11. Estilização

  • styling-cn-utility - Combine clsx e tailwind-merge
  • styling-order - Base → Variantes → Condicionais → Sobrescrições do usuário
  • styling-cva - Class Variance Authority para variantes
  • styling-css-variables - Valores dinâmicos com variáveis CSS

12. Design Tokens

  • design-tokens-css-variables - Defina tokens como variáveis CSS
  • design-tokens-theming - Suporte a modos claro/escuro e temas

13. Documentação

  • documentation-props - Documente todas as props com JSDoc
  • documentation-examples - Forneça exemplos de uso

14. Registro

  • registry-structure - Estrutura de arquivo do registro
  • registry-schema - Esquema de metadados do componente

15. NPM

  • npm-package-json - Configuração do pacote
  • npm-exports - Exportações do módulo

16. Marketplaces

  • marketplaces-distribution - Estratégias de distribuição de componentes

Como Usar

Leia arquivos de regra individuais para explicações detalhadas e exemplos de código:

rules/composition/SKILL.md
rules/accessibility/SKILL.md
rules/styling/SKILL.md

Cada arquivo de regra contém:

  • Breve explicação de por que é importante
  • Exemplo de código incorreto com explicação
  • Exemplo de código correto com explicação
  • Melhores práticas e armadilhas comuns

Documento Completo Compilado

Para o guia completo com todas as regras expandidas: AGENTS.md

Princípios Chave

  1. Composição sobre Configuração - Divida componentes em subcomponentes componíveis
  2. Acessibilidade por Padrão - Não é um pensamento posterior, mas um requisito
  3. Empacotamento de Elemento Único - Cada componente envolve um elemento HTML
  4. Estenda Atributos HTML - Sempre estenda props de elementos nativos
  5. Exporte Tipos - Torne os tipos de props disponíveis para consumidores
  6. Suporte Ambos os Padrões de Estado - Controlado e não controlado
  7. Mesclagem Inteligente de Classes - Use o utilitário cn() com tailwind-merge

Autores

Co-autorado por:

Adaptado como um skill de IA por:

Baseado na especificação components.build.

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

Habilidades Relacionadas