Communitygithub.com

Components.build Spezifikation

Erstelle moderne, komponierbare und barrierefreie React-UI-Komponenten gemäß der Components.build-Spezifikation. Verwende dies beim Erstellen, Überprüfen oder Refaktorieren von Komponentenbibliotheken, Designsystemen oder wiederverwendbaren UI-Komponenten.

Was ist Components.build Spezifikation?

Diese KI-Fertigkeit implementiert die Components.build-Spezifikation, eine umfassende Sammlung von 16 Regelkategorien zur Entwicklung moderner, komponierbarer und barrierefreier React-Komponenten. Sie ist besonders nützlich für Entwickler, die Komponentenbibliotheken, Designsysteme oder wiederverwendbare UI-Komponenten erstellen, überprüfen oder umgestalten. Die Fertigkeit unterstützt die Plattformen Claude Code, Cursor und andere KI-gestützte Entwicklungsumgebungen und deckt Bereiche wie Komposition, Barrierefreiheit (Tastatur, ARIA, Fokusmanagement), Zustandsmuster (controlled/uncontrolled), TypeScript-Typen, Polymorphismus, Styling mit Tailwind CSS/CVA, Design-Tokens und die Verteilung über Registries oder npm ab. Sie basiert auf den Regeln von components.build und enthält detaillierte Quellverweise, Codebeispiele und Best Practices für jeden Bereich, sodass sie als vollständiger Architekturleitfaden für jede moderne React-Komponentenbibliothek dient.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Components.build Spezifikation?

Umfassende Richtlinien zur Erstellung moderner, komponierbarer und barrierefreier UI-Komponenten. Enthält 16 Regelkategorien, die von Kernprinzipien bis zur Verteilung reichen, gemeinsam verfasst von Hayden Bleasel und shadcn.

Wann anzuwenden

Beziehe dich auf diese Richtlinien, wenn:

  • Neue React-Komponenten oder Komponentenbibliotheken erstellt werden
  • Komponenten-APIs und Props-Schnittstellen entworfen werden
  • Barrierefreiheitsfunktionen (Tastatur, ARIA, Fokusverwaltung) implementiert werden
  • Komponierbare Komponentenarchitekturen aufgebaut werden
  • Komponenten mit Tailwind CSS und CVA gestylt werden
  • Komponenten in Registries oder npm veröffentlicht werden

Regelkategorien nach Priorität

PrioritätKategorieFokusPräfix
1ÜbersichtUmfang und Ziele der Spezifikationoverview
2PrinzipienKern-Designphilosophieprinciples
3DefinitionenAllgemeine Terminologiedefinitions
4KompositionAufteilung komplexer Komponentencomposition
5BarrierefreiheitTastatur, Screenreader, ARIAaccessibility
6ZustandControlled/uncontrolled-Musterstate
7TypenTypeScript-Props und -Schnittstellentypes
8PolymorphismusElementwechsel mit der as-Proppolymorphism
9As-ChildRadix-Slot-Kompositionsmusteras-child
10Datenattributedata-state und data-slotdata-attributes
11StylingTailwind CSS, cn-Hilfsfunktion, CVAstyling
12Design-TokensCSS-Variablen und Themingdesign-tokens
13DokumentationKomponentendokumentationdocumentation
14RegistryKomponenten-Registriesregistry
15NPMVeröffentlichung auf npmnpm
16MarktplätzeKomponenten-Marktplätzemarketplaces

Kurzreferenz

1. Übersicht

  • overview - Umfang, Ziele und Philosophie der Spezifikation

2. Prinzipien

  • principles - Komponierbarkeit, Barrierefreiheit, Anpassbarkeit, Transparenz

3. Definitionen

  • definitions - Allgemeine Terminologie (primitiv, zusammengesetzt, headless, usw.)

4. Komposition

  • composition-root - Root-Komponente mit Kontext für gemeinsamen Zustand
  • composition-item - Item-Wrapper-Komponenten
  • composition-trigger - Interaktive Trigger-Komponenten
  • composition-content - Inhaltsanzeige-Komponenten
  • composition-export - Namespace-Exportmuster

5. Barrierefreiheit

  • accessibility-semantic-html - Verwendung geeigneter HTML-Elemente
  • accessibility-keyboard - Vollständige Tastaturnavigation
  • accessibility-aria - Korrekte ARIA-Rollen, -Zustände und -Eigenschaften
  • accessibility-focus - Fokusverwaltung und -wiederherstellung
  • accessibility-live-regions - Screenreader-Ankündigungen
  • accessibility-contrast - Farbkontrastanforderungen

6. Zustand

  • state-uncontrolled - Internes Zustandsmanagement
  • state-controlled - Externes Zustandsmanagement
  • state-controllable - Unterstützung beider Muster mit useControllableState

7. Typen

  • types-extend-html - Erweiterung nativer HTML-Attribute
  • types-export - Export von Prop-Typen für Konsumenten
  • types-single-element - Eine Komponente umschließt ein Element

8. Polymorphismus

  • polymorphism-as-prop - Änderung des gerenderten Elementtyps
  • polymorphism-typescript - Typsichere polymorphe Komponenten
  • polymorphism-defaults - Semantische Standardelemente

9. As-Child

  • as-child-slot - Radix-Slot zur Prop-Verschmelzung
  • as-child-composition - Komposition mit Kindkomponenten

10. Datenattribute

  • data-attributes-state - Verwendung von data-state zum Stylen von Zuständen
  • data-attributes-slot - Verwendung von data-slot zur Zielbestimmung von Unterkomponenten

11. Styling

  • styling-cn-utility - Kombination von clsx und tailwind-merge
  • styling-order - Basis → Varianten → Bedingungen → Benutzer-Override
  • styling-cva - Class Variance Authority für Varianten
  • styling-css-variables - Dynamische Werte mit CSS-Variablen

12. Design-Tokens

  • design-tokens-css-variables - Definition von Tokens als CSS-Variablen
  • design-tokens-theming - Unterstützung von Hell-/Dunkelmodi und Themes

13. Dokumentation

  • documentation-props - Dokumentation aller Props mit JSDoc
  • documentation-examples - Bereitstellung von Nutzungsbeispielen

14. Registry

  • registry-structure - Dateistruktur der Registry
  • registry-schema - Metadatenschema der Komponente

15. NPM

  • npm-package-json - Paketkonfiguration
  • npm-exports - Modul-Exporte

16. Marktplätze

  • marketplaces-distribution - Strategien zur Komponentenverteilung

Verwendung

Lies die einzelnen Regeldateien für detaillierte Erklärungen und Codebeispiele:

regeln/komposition/SKILL.md
regeln/barrierefreiheit/SKILL.md
regeln/styling/SKILL.md

Jede Regeldatei enthält:

  • Kurze Erklärung, warum sie wichtig ist
  • Falsches Codebeispiel mit Erklärung
  • Korrektes Codebeispiel mit Erklärung
  • Best Practices und häufige Fehler

Vollständig kompiliertes Dokument

Für die vollständige Anleitung mit allen erweiterten Regeln: AGENTS.md

Wichtige Prinzipien

  1. Komposition vor Konfiguration - Zerlege Komponenten in komponierbare Unterkomponenten
  2. Barrierefreiheit standardmäßig - Kein nachträglicher Gedanke, sondern eine Anforderung
  3. Einzelnes Element umschließen - Jede Komponente umschließt ein HTML-Element
  4. HTML-Attribute erweitern - Erweitere immer native Element-Props
  5. Typen exportieren - Mache Prop-Typen für Konsumenten verfügbar
  6. Beide Zustandsmuster unterstützen - Controlled und uncontrolled
  7. Intelligente Klassen-Verschmelzung - Verwende die cn()-Hilfsfunktion mit tailwind-merge

Autoren

Gemeinsam verfasst von:

Als KI-Fertigkeit adaptiert von:

Basiert auf der components.build-Spezifikation.

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

Verwandte Skills