Communitygithub.com

ulasalyesil/personal-website-v2

Construisez des composants React modernes, composables et accessibles selon la spécification components.build. À utiliser lors de la création, de la révision ou du refactoring de bibliothèques de composants, de design systems ou de tout composant UI réutilisable.

Qu'est-ce que personal-website-v2 ?

Ce skill implémente la spécification **components.build**, un guide complet de 16 catégories de règles pour construire des composants React modernes, composables et accessibles. Coécrit par Hayden Bleasel et shadcn, il couvre les principes fondamentaux (composition, accessibilité par défaut), la gestion d'état (contrôlé/non contrôlé), le polymorphisme via la prop `as`, le motif `as-child` de Radix Slot, les attributs de données (`data-state`, `data-slot`), le styling avec Tailwind CSS et CVA, les tokens de design CSS, la documentation JSDoc, et la distribution via registres ou npm. Idéal pour les développeurs utilisant des agents comme Claude Code ou Cursor, ce skill garantit des composants robustes, maintenables et conformes aux standards d'accessibilité. Il fournit des règles claires avec exemples corrects/incorrects à appliquer lors de la création, révision ou refactoring de composants.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Spécification components.build

Directives complètes pour la construction de composants UI modernes, composables et accessibles. Contient 16 catégories de règles couvrant des principes fondamentaux à la distribution, coécrit par Hayden Bleasel et shadcn.

Quand appliquer

Consultez ces directives lorsque :

  • Vous créez de nouveaux composants React ou des bibliothèques de composants
  • Vous concevez des API de composants et des interfaces de props
  • Vous implémentez des fonctionnalités d'accessibilité (clavier, ARIA, gestion du focus)
  • Vous construisez des architectures de composants composables
  • Vous stylisez des composants avec Tailwind CSS et CVA
  • Vous publiez des composants dans des registres ou sur npm

Catégories de règles par priorité

PrioritéCatégorieObjectifPréfixe
1AperçuPortée et objectifs de la spécificationoverview
2PrincipesPhilosophie de conception fondamentaleprinciples
3DéfinitionsTerminologie communedefinitions
4CompositionDécomposition des composants complexescomposition
5AccessibilitéClavier, lecteurs d'écran, ARIAaccessibility
6ÉtatModèles contrôlés/non contrôlésstate
7TypesProps et interfaces TypeScripttypes
8PolymorphismeChangement d'élément avec la prop aspolymorphism
9As-ChildModèle de composition Radix Slotas-child
10Attributs de donnéesdata-state et data-slotdata-attributes
11StylismeTailwind CSS, utilitaire cn, CVAstyling
12Tokens de designVariables CSS et thèmesdesign-tokens
13DocumentationDocumentation des composantsdocumentation
14RegistreRegistres de composantsregistry
15NPMPublication sur npmnpm
16Places de marchéPlaces de marché de composantsmarketplaces

Référence rapide

1. Aperçu

  • overview - Portée, objectifs et philosophie de la spécification

2. Principes

  • principles - Composabilité, accessibilité, personnalisation, transparence

3. Définitions

  • definitions - Terminologie commune (primitif, composé, headless, etc.)

4. Composition

  • composition-root - Composant racine avec Context pour l'état partagé
  • composition-item - Composants d'encapsulation d'élément
  • composition-trigger - Composants déclencheurs interactifs
  • composition-content - Composants d'affichage de contenu
  • composition-export - Modèle d'export par espace de noms

5. Accessibilité

  • accessibility-semantic-html - Utiliser des éléments HTML appropriés
  • accessibility-keyboard - Prise en charge complète de la navigation au clavier
  • accessibility-aria - Rôles, états et propriétés ARIA corrects
  • accessibility-focus - Gestion et restauration du focus
  • accessibility-live-regions - Annonces pour lecteurs d'écran
  • accessibility-contrast - Exigences de contraste des couleurs

6. État

  • state-uncontrolled - Gestion d'état interne
  • state-controlled - Délégation d'état externe
  • state-controllable - Prise en charge des deux modèles avec useControllableState

7. Types

  • types-extend-html - Étendre les attributs HTML natifs
  • types-export - Exporter les types de props pour les consommateurs
  • types-single-element - Un composant encapsule un élément

8. Polymorphisme

  • polymorphism-as-prop - Modifier le type d'élément rendu
  • polymorphism-typescript - Composants polymorphes type-safe
  • polymorphism-defaults - Valeurs par défaut sémantiques des éléments

9. As-Child

  • as-child-slot - Radix Slot pour la fusion de props
  • as-child-composition - Composer avec des composants enfants

10. Attributs de données

  • data-attributes-state - Utiliser data-state pour le style des états
  • data-attributes-slot - Utiliser data-slot pour cibler les sous-composants

11. Stylisme

  • styling-cn-utility - Combiner clsx et tailwind-merge
  • styling-order - Base → Variantes → Conditionnelles → Surcharges utilisateur
  • styling-cva - Class Variance Authority pour les variantes
  • styling-css-variables - Valeurs dynamiques avec variables CSS

12. Tokens de design

  • design-tokens-css-variables - Définir les tokens comme variables CSS
  • design-tokens-theming - Prise en charge des modes clair/sombre et des thèmes

13. Documentation

  • documentation-props - Documenter toutes les props avec JSDoc
  • documentation-examples - Fournir des exemples d'utilisation

14. Registre

  • registry-structure - Structure des fichiers du registre
  • registry-schema - Schéma des métadonnées des composants

15. NPM

  • npm-package-json - Configuration du package
  • npm-exports - Exportations de modules

16. Places de marché

  • marketplaces-distribution - Stratégies de distribution de composants

Comment utiliser

Lisez les fichiers de règles individuels pour des explications détaillées et des exemples de code :

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

Chaque fichier de règle contient :

  • Une brève explication de son importance
  • Un exemple de code incorrect avec explication
  • Un exemple de code correct avec explication
  • Bonnes pratiques et pièges courants

Document complet compilé

Pour le guide complet avec toutes les règles développées : AGENTS.md

Principes clés

  1. Composition plutôt que configuration - Décomposer les composants en sous-composants composables
  2. Accessibilité par défaut - Pas une réflexion après coup, mais une exigence
  3. Encapsulation d'un seul élément - Chaque composant encapsule un élément HTML
  4. Étendre les attributs HTML - Toujours étendre les props des éléments natifs
  5. Exporter les types - Rendre les types de props disponibles pour les consommateurs
  6. Prendre en charge les deux modèles d'état - Contrôlé et non contrôlé
  7. Fusion intelligente des classes - Utiliser l'utilitaire cn() avec tailwind-merge

Auteurs

Coécrit par :

Adapté en skill IA par :

Basé sur la spécification 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 associés