Communitygithub.com

ulasalyesil/sitio-web-personal-v2

Construye componentes de interfaz de usuario React modernos, componibles y accesibles siguiendo la especificación de components.build. Úsalo al crear, revisar o refactorizar bibliotecas de componentes, sistemas de diseño o cualquier componente UI reutilizable. Se activa en tareas que involucran API de componentes, patrones de composición, accesibilidad, sistemas de estilo o props de TypeScript.

¿Qué es sitio-web-personal-v2?

Este skill guía a los agentes de IA en la creación de componentes React modernos, componibles y accesibles, basándose en la especificación de components.build, coautorada por Hayden Bleasel y shadcn. Proporciona un conjunto completo de 16 categorías de reglas que cubren desde principios fundamentales hasta distribución en marketplaces y npm. Las reglas detallan cómo diseñar APIs de componentes, implementar accesibilidad (teclado, ARIA, manejo de foco), gestionar estados controlados y no controlados, y usar patrones de composición como As-Child con Radix Slot. También incluye pautas para tipado con TypeScript, estilizado con Tailwind CSS y CVA, tokens de diseño, documentación con JSDoc, y estructura de registros. Es útil para cualquier agente que trabaje en sistemas de diseño, bibliotecas de componentes o piezas UI reutilizables en React, asegurando consistencia, accesibilidad y mantenibilidad. Compatible con plataformas como Claude Code, Cursor, Codex y otras herramientas de IA que ejecuten skills.

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

Preguntar en tu IA favorita

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

Documentación

Especificación components.build

Guía completa para construir componentes UI modernos, componibles y accesibles. Contiene 16 categorías de reglas que abarcan desde principios básicos hasta distribución, coautorada por Hayden Bleasel y shadcn.

Cuándo aplicar

Consulta estas pautas cuando:

  • Creando nuevos componentes React o bibliotecas de componentes
  • Diseñando APIs de componentes e interfaces de props
  • Implementando funcionalidades de accesibilidad (teclado, ARIA, manejo de foco)
  • Construyendo arquitecturas de componentes componibles
  • Estilizando componentes con Tailwind CSS y CVA
  • Publicando componentes en registros o npm

Categorías de reglas por prioridad

PrioridadCategoríaEnfoquePrefijo
1Visión GeneralAlcance y objetivos de la especificaciónoverview
2PrincipiosFilosofía central de diseñoprinciples
3DefinicionesTerminología comúndefinitions
4ComposiciónDescomposición de componentes complejoscomposition
5AccesibilidadTeclado, lectores de pantalla, ARIAaccessibility
6EstadoPatrones controlados/no controladosstate
7TiposProps e interfaces de TypeScripttypes
8PolimorfismoCambio de elemento con prop aspolymorphism
9As-ChildPatrón de composición Radix Slotas-child
10Atributos de datosdata-state y data-slotdata-attributes
11EstilizadoTailwind CSS, utilidad cn, CVAstyling
12Tokens de diseñoVariables CSS y tematizacióndesign-tokens
13DocumentaciónDocumentación de componentesdocumentation
14RegistroRegistros de componentesregistry
15NPMPublicación en npmnpm
16MarketplacesMercados de componentesmarketplaces

Referencia rápida

1. Visión General

  • overview - Alcance, objetivos y filosofía de la especificación

2. Principios

  • principles - Componibilidad, accesibilidad, personalización, transparencia

3. Definiciones

  • definitions - Terminología común (primitivo, compuesto, headless, etc.)

4. Composición

  • composition-root - Componente raíz con Context para estado compartido
  • composition-item - Componentes envoltorio de ítems
  • composition-trigger - Componentes de activación interactivos
  • composition-content - Componentes de visualización de contenido
  • composition-export - Patrón de exportación por espacio de nombres

5. Accesibilidad

  • accessibility-semantic-html - Usar elementos HTML apropiados
  • accessibility-keyboard - Soporte completo de navegación por teclado
  • accessibility-aria - Roles, estados y propiedades ARIA adecuados
  • accessibility-focus - Manejo y restauración del foco
  • accessibility-live-regions - Anuncios para lectores de pantalla
  • accessibility-contrast - Requisitos de contraste de color

6. Estado

  • state-uncontrolled - Gestión de estado interno
  • state-controlled - Delegación de estado externo
  • state-controllable - Soporte de ambos patrones con useControllableState

7. Tipos

  • types-extend-html - Extender atributos HTML nativos
  • types-export - Exportar tipos de props para consumidores
  • types-single-element - Un componente envuelve un elemento

8. Polimorfismo

  • polymorphism-as-prop - Cambiar el tipo de elemento renderizado
  • polymorphism-typescript - Componentes polimórficos con seguridad de tipos
  • polymorphism-defaults - Valores por defecto semánticos de elementos

9. As-Child

  • as-child-slot - Radix Slot para fusión de props
  • as-child-composition - Componer con componentes hijos

10. Atributos de datos

  • data-attributes-state - Usar data-state para estilizar estados
  • data-attributes-slot - Usar data-slot para apuntar a subcomponentes

11. Estilizado

  • styling-cn-utility - Combinar clsx y tailwind-merge
  • styling-order - Base → Variantes → Condicionales → Sobrescrituras de usuario
  • styling-cva - Class Variance Authority para variantes
  • styling-css-variables - Valores dinámicos con variables CSS

12. Tokens de diseño

  • design-tokens-css-variables - Definir tokens como variables CSS
  • design-tokens-theming - Soporte de modos claro/oscuro y temas

13. Documentación

  • documentation-props - Documentar todas las props con JSDoc
  • documentation-examples - Proporcionar ejemplos de uso

14. Registro

  • registry-structure - Estructura de archivos del registro
  • registry-schema - Esquema de metadatos de componentes

15. NPM

  • npm-package-json - Configuración del paquete
  • npm-exports - Exportaciones del módulo

16. Marketplaces

  • marketplaces-distribution - Estrategias de distribución de componentes

Cómo usar

Lee archivos de reglas individuales para obtener explicaciones detalladas y ejemplos de código:

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

Cada archivo de regla contiene:

  • Breve explicación de por qué es importante
  • Ejemplo de código incorrecto con explicación
  • Ejemplo de código correcto con explicación
  • Mejores prácticas y errores comunes

Documento completo compilado

Para la guía completa con todas las reglas expandidas: AGENTS.md

Principios clave

  1. Composición sobre Configuración - Descomponer componentes en subcomponentes componibles
  2. Accesibilidad por defecto - No es un añadido, sino un requisito
  3. Envoltura de elemento único - Cada componente envuelve un elemento HTML
  4. Extender atributos HTML - Siempre extender las props nativas de los elementos
  5. Exportar tipos - Hacer que los tipos de props estén disponibles para los consumidores
  6. Soportar ambos patrones de estado - Controlado y no controlado
  7. Fusión inteligente de clases - Usar la utilidad cn() con tailwind-merge

Autores

Coautorado por:

Adaptado como skill de IA por:

Basado en la especificación 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

Skills relacionados