Skills vercel components.build
building-components
- Use it when:
- You're building UI primitives, components, blocks or templates, especially ones other developers will install and customize.
- It does:
- Points the agent to the chapter of the components.build specification that fits the task.
- Covers:
- Accessibility, composition, as-child and polymorphism, TypeScript types, controlled and uncontrolled state, data attributes, design tokens, styling and docs.
- Also:
- Distributing components through npm, shadcn-style registries and marketplaces.
TL;DR
The skill is an index to components.build, an open specification for building UI components for the web, split into fifteen reference files. Its definitions separate primitives, unstyled building blocks that handle behaviour and accessibility such as Radix or React Aria, from styled components, blocks and templates. Its principles favour composition over inheritance, accessibility as a baseline with semantic HTML, ARIA and keyboard support, styles that can be overridden through tokens or class names, few dependencies, and code users can read and change, the idea behind copy-and-paste distribution. Other files cover patterns such as as-child, polymorphism, slots and controlled state, plus publishing and documenting components. Its terms are framework-agnostic, with React for examples. It holds guidance only and changes nothing by itself.
Summarizes the skill at ba72745.
npx skills add https://github.com/vercel/components.build --skill building-components skills.sh pageSource on GitHubAll skills from vercel/components.build
- Total Downloads
- 15,100 on skills.sh, Nov 9, 2026
- Repo stars
- 802 vercel/components.build
- First seen
- Feb 4, 2026 on skills.sh
Weekly values
| Week to | Installs |
|---|---|
| Sep 21 | 381 |
| Sep 28 | 303 |
| Oct 5 | 305 |
| Oct 12 | 306 |
| Oct 19 | 282 |
| Oct 26 | 222 |
| Nov 2 | 217 |
| Nov 9 | 177 |
| Category |
Taste for interfaces that don't look generated: direction, motion and accessibility. Everything for building software: planning, coding, debugging, design, frameworks, cloud, agents and skills. |
|---|---|
| Type |
Knowledge and rules the agent applies while it works: best practices, design principles, API references. |
| Effect |
Adds no side effects of its own. It shapes how the agent thinks, writes or reviews. Guidelines and routers are always effect:none, even when the task they support edits code. |
| Needs |
Instructions only. Works in any agent that supports skills. |
| Publisher |
A verified publisher on skills.sh, or the company or maintainer behind the product the skill operates. |
| Topics | |
| Stack |
SKILL.md
From vercel/components.build at ba72745. Checked daily, last changed Nov 6, 2026.
Frontmatter
name: building-components
description: Guide for building modern, accessible, and composable UI components. Use when building new components, implementing accessibility, creating composable APIs, setting up design tokens, publishing to npm/registry, or writing component documentation.Building Components
When to use this skill
Use when the user is:
- Building new UI components (primitives, components, blocks, templates)
- Implementing accessibility features (ARIA, keyboard navigation, focus management)
- Creating composable component APIs (slots, render props, controlled/uncontrolled state)
- Setting up design tokens and theming systems
- Publishing components to npm or a registry
- Writing component documentation
- Implementing polymorphism or as-child patterns
- Working with data attributes for styling/state
References
- definitions.mdx - Artifact taxonomy (primitives, components, blocks, templates)
- principles.mdx - Core principles for component design
- accessibility.mdx - ARIA, keyboard navigation, WCAG compliance
- composition.mdx - Composable component patterns
- as-child.mdx - The as-child pattern for element polymorphism
- polymorphism.mdx - Polymorphic component patterns
- types.mdx - TypeScript typing patterns for components
- state.mdx - Controlled vs uncontrolled state management
- data-attributes.mdx - Using data attributes for styling and state
- design-tokens.mdx - Design token systems and theming
- styling.mdx - Component styling approaches
- registry.mdx - shadcn-style registry distribution
- npm.mdx - Publishing components to npm
- marketplaces.mdx - Component marketplace distribution
- docs.mdx - Writing component documentation