Agent skill

UI Components

by yonatangross in yonatangross/orchestkit

UI component library patterns for shadcn/ui and Radix Primitives.

MITAuto-check passedFrontend & Design

Install UI Components

skills CLI
$ npx skills add yonatangross/orchestkit --skill ui-components -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install yonatangross/orchestkit ui-components --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/yonatangross/orchestkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/skills/ui-components .claude/skills/ui-components && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ui-components
GitHub stars
289
Token cost
~2.9k tokens
SKILL.md length
977 words
Files
28 (incl. scripts, references)
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

UI component library patterns for shadcn/ui and Radix Primitives.

  • Building accessible component libraries
  • SKILL.md covers Quick Reference, Quick Start, shadcn/ui and Key Decisions, plus 9 more sections
  • Calls npx
  • Customizing shadcn components

What it does

UI Components is an agent skill from yonatangross/orchestkit. UI component library patterns for shadcn/ui and Radix Primitives. Use when building accessible component libraries, customizing shadcn components, using Radix unstyled primitives, or creating design system foundations.

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 29 other files, including scripts and reference files (for example `metadata.json`, `references/ork-delta.md` and `rules/_sections.md`). Compatibility notes: Claude Code 2.1.277+.

It sits in Frontend & Design, covering Design systems. It works with shadcn/ui and Radix UI. The repository describes itself as: The Complete AI Development Toolkit for Claude Code. 106 skills, 36 agents, 171 hooks. Install ork for stable (v9.x), or ork-alpha for the v10 line, which ships daily. The licence is MIT.

When your agent uses it

  • Building accessible component libraries
  • Customizing shadcn components
  • Using Radix unstyled primitives
  • Creating design system foundations

Example prompts

  • “/ui-components”

Requirements

  • Node.js
  • Compatibility (from SKILL.md): Claude Code 2.1.277+.
  • Pre-approved tools (allowed-tools): Read, Glob, Grep, WebFetch, WebSearch

What it can do on your machine

Read from SKILL.md and the folder at commit 0ef71d2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep
    • WebFetch
    • WebSearch

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • ui.shadcn.com
    • radix-ui.com
    • cva.style
    • github.com
    • tanstack.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Claude Code 2.1.277+.

    From compatibility in the SKILL.md frontmatter.

Context cost

UI Components loads about 2.9k tokens when it runs, and up to ~3.8k if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 977 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from yonatangross/orchestkit at commit 0ef71d2, republished under its MIT licence (© yonatangross). 977 words, ~2,947 tokens.

Download SKILL.mdSave it as .claude/skills/ui-components/SKILL.md (or your agent's skills folder). This skill also uses 27 other files; get the full folder from GitHub.
name
ui-components
description
UI component library patterns for shadcn/ui and Radix Primitives. Use when building accessible component libraries, customizing shadcn components, using Radix unstyled primitives, or creating design system foundations.
allowed-tools
Read, Glob, Grep, WebFetch, WebSearch
compatibility
Claude Code 2.1.277+.
license
MIT
user-invocable
false
disable-model-invocation
true
metadata.owner-agent
frontend-ui-developer
metadata.category
document-asset-creation
metadata.version
2.1.0
metadata.author
OrchestKit
metadata.complexity
medium
metadata.tags
ui-components, shadcn, radix, component-library, design-system, accessible-components, react-hook-form, zod, forms, validation, server-actions, field-arrays

UI Components

Patterns for building accessible UI component libraries with shadcn/ui and Radix Primitives, as a thin wrap over the first-party docs: quick-start recipes, key decisions, anti-patterns, and the house delta. Vendor mechanics (CVA variants, cn() utility, component extension, asChild composition, dialog/menu patterns, data-attribute styling) are upstream's job; see Upstream coverage (do not restate). Each remaining category has individual rule files in rules/ loaded on-demand.

Quick Reference

CategoryRulesImpactWhen to Use
shadcn/ui1HIGHv4 styles, preset codes, style detection
Design System4HIGHW3C tokens, OKLCH theming, spacing scales, typography, component states, animation
Design System Components1HIGHAtomic design, CVA variants, accessibility, Storybook
Forms2HIGHReact Hook Form v7, Zod validation, Server Actions
Modern CSS & Tooling3HIGHCSS cascade layers, Tailwind v4, Storybook CSF3
UX Foundations4HIGHVisual hierarchy, typography thresholds, color system, empty states

Total: 15 rules across 6 categories. Radix primitive mechanics and shadcn customization tutorials are first-party documented; see Upstream coverage (do not restate) and references/ork-delta.md for what stays ours.

Quick Start

tsx
// CVA variant system with cn() utility
import { cva, type VariantProps } from 'class-variance-authority'
import { cn } from '@/lib/utils'

const buttonVariants = cva(
  'inline-flex items-center justify-center rounded-md font-medium transition-colors',
  {
    variants: {
      variant: {
        default: 'bg-primary text-primary-foreground hover:bg-primary/90',
        destructive: 'bg-destructive text-destructive-foreground',
        outline: 'border border-input bg-background hover:bg-accent',
        ghost: 'hover:bg-accent hover:text-accent-foreground',
      },
      size: {
        default: 'h-10 px-4 py-2',
        sm: 'h-9 px-3',
        lg: 'h-11 px-8',
      },
    },
    defaultVariants: { variant: 'default', size: 'default' },
  }
)
tsx
// Radix Dialog with asChild composition
import { Dialog } from 'radix-ui'

<Dialog.Root>
  <Dialog.Trigger asChild>
    <Button>Open</Button>
  </Dialog.Trigger>
  <Dialog.Portal>
    <Dialog.Overlay className="fixed inset-0 bg-black/50" />
    <Dialog.Content className="data-[state=open]:animate-in">
      <Dialog.Title>Title</Dialog.Title>
      <Dialog.Description>Description</Dialog.Description>
      <Dialog.Close>Close</Dialog.Close>
    </Dialog.Content>
  </Dialog.Portal>
</Dialog.Root>

shadcn/ui

Beautifully designed, accessible components built on CVA variants, cn() utility, and OKLCH theming.

RuleFileKey Pattern
v4 Stylesrules/shadcn-v4-styles.md6 styles (Vega→Luma), preset codes, style detection, class mapping

Customization, form, and data-table walkthroughs are upstream's job now; see Upstream coverage (do not restate). Our conventions on top of them live in references/ork-delta.md.

v4 Style System

shadcn CLI v4 ships 6 visual styles. Each rewrites component class names — not just CSS variables.

StyleCharacterBest For
VegaBalanced radius, clean linesGeneral purpose (successor to New York)
NovaCompact padding, reduced marginsDense dashboards, admin panels
MaiaSoft, rounded, generous spacingConsumer-facing, friendly apps
LyraSharp, zero radius, monospace pairsEditorial, developer tools
MiraUltra-compact, minimal chromeSpreadsheets, data-heavy interfaces
LumaExtreme rounding (rounded-4xl), soft elevation (shadow-md + ring), breathable layoutsPolished native-app feel, macOS Tahoe-inspired

Configure visually at ui.shadcn.com/create → pick style, theme, fonts, icons, then copy the generated command. Do not hardcode preset codes in docs — they're tied to a specific style snapshot and can drift.

shadcn CLI v4 (Apr 2026) — new commands
CommandPurpose
npx shadcn@latest apply <style>Apply a published style (e.g. luma, nova, lyra) to the current project — re-skins existing components without re-adding them
npx shadcn@latest infoShow resolved config: registry, style, tokens, components present, Tailwind version
npx shadcn@latest skillsList the shadcn/skills registry — Claude Code- and Cursor-ready skill packs that bundle CLI commands with agent guidance
npx shadcn@latest buildBuild a custom registry (already-documented) — pair with apply to ship a private style

Detection: Read components.json → "style" field (e.g., "radix-luma", "base-nova"). Old "new-york" and "default" styles are superseded by Vega.

Key Decisions

DecisionRecommendation
Color formatOKLCH for perceptually uniform theming
Class mergingAlways use cn() for Tailwind conflicts
Extending componentsWrap, don't modify source files
VariantsUse CVA for type-safe multi-axis variants
Styling approachData attributes + Tailwind arbitrary variants
CompositionUse asChild to avoid wrapper divs
AnimationCSS-only with data-state selectors
Form componentsCombine with react-hook-form
Destructive confirmationsAlertDialog, never plain Dialog (see references/ork-delta.md)

Anti-Patterns (FORBIDDEN)

  • Modifying shadcn source: Wrap and extend instead of editing generated files
  • Skipping cn(): Direct string concatenation causes Tailwind class conflicts
  • Inline styles over CVA: Use CVA for type-safe, reusable variants
  • Wrapper divs: Use asChild to avoid extra DOM elements
  • Missing Dialog.Title: Every dialog must have an accessible title
  • Positive tabindex: Using tabindex > 0 disrupts natural tab order
  • Color-only states: Use data attributes + multiple indicators
  • Manual focus management: Use Radix built-in focus trapping
Show full SKILL.md (402 more words)Show less

Upstream coverage (do not restate)

These topics were removed from this skill on 2026-07-31 because a first-party source owns them. Point sessions at the source; keep only floors, scars, and house decisions here (they live in references/ork-delta.md).

TopicFirst-party source
shadcn setup, init checklist, adding componentsvercel:shadcn (marketplace skill), https://ui.shadcn.com/docs/installation
shadcn customization, CVA variants, cn() utility, component extensionvercel:shadcn (marketplace skill), https://ui.shadcn.com/docs and https://cva.style/docs
OKLCH theming variables, light/dark CSS variable setshttps://ui.shadcn.com/docs/theming
Dark mode toggle with next-themeshttps://ui.shadcn.com/docs/dark-mode and https://github.com/pacocoursey/next-themes
Data table with TanStack Tablehttps://ui.shadcn.com/docs/components/data-table and https://tanstack.com/table
Form field wrappers and validation stateshttps://ui.shadcn.com/docs/components/form
Radix Dialog and AlertDialog patternshttps://www.radix-ui.com/primitives/docs/components/dialog and .../components/alert-dialog
Radix asChild / Slot compositionhttps://www.radix-ui.com/primitives/docs/guides/composition
Radix data-attribute styling and focus managementhttps://www.radix-ui.com/primitives/docs/guides/styling
Dropdown menu, popover, tooltip, hover cardhttps://www.radix-ui.com/primitives/docs/components/dropdown-menu (and sibling component pages)
Radix accessibility audit checklisthttps://www.radix-ui.com/primitives/docs/overview/accessibility plus ork:accessibility

Detailed Documentation

ResourceDescription
scripts/Templates: CVA component, extended button, dialog, dropdown, theme CSS
references/ork-delta.mdOrk floors, scars, and house decisions kept out of upstream docs

Design System

Design token architecture, spacing, typography, and interactive component states.

RuleFileKey Pattern
Token Architecturerules/design-system-tokens.mdW3C tokens, OKLCH colors, Tailwind @theme
Spacing Scalerules/design-system-spacing.md8px grid, Tailwind space-1 to space-12
Typography Scalerules/design-system-typography.mdFont sizes, weights, line heights
Component Statesrules/design-system-states.mdHover, focus, active, disabled, loading, animation presets

Design System Components

Component architecture patterns with atomic design and accessibility.

RuleFileKey Pattern
Component Architecturerules/design-system-components.mdAtomic design, CVA variants, WCAG 2.1 AA, Storybook

Forms

React Hook Form v7 with Zod validation and React 19 Server Actions.

RuleFileKey Pattern
React Hook Formrules/forms-react-hook-form.mduseForm, field arrays, Controller, wizards, file uploads
Zod & Server Actionsrules/forms-validation-zod.mdZod schemas, Server Actions, useActionState, async validation

Modern CSS & Tooling

Modern CSS patterns, Tailwind v4, and component documentation tooling for 2026.

RuleFileKey Pattern
CSS Cascade Layersrules/css-cascade-layers.md@layer ordering, specificity-free overrides, third-party isolation
Tailwind v4rules/tailwind-v4-patterns.mdCSS-first @theme, native container queries, @max-* variants
Storybook Docsrules/storybook-component-docs.mdCSF3 stories, play() interaction tests, Chromatic visual regression

UX Foundations

Cognitive-science-grounded UI/UX principles with specific numeric thresholds for production-quality interfaces.

RuleFileKey Pattern
Visual Hierarchyrules/visual-hierarchy.mdButton tiers, de-emphasis, F/Z scan, Von Restorff, proximity, max-width
Typography Thresholdsrules/typography-thresholds.md65ch line length, 1.4–1.6 line height, rem units, modular type scale
Color Systemrules/color-system.mdOKLCH 9-shade scales, semantic categories, no true black, brand-tinted neutrals
Empty Statesrules/empty-states.mdSkeleton-first, icon + headline + description + CTA, cause-specific tone
  • ork:accessibility - WCAG compliance and React Aria patterns
  • ork:testing-unit - Component testing patterns

© yonatangross, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 27 other files (scripts, references) in src/skills/ui-components of yonatangross/orchestkit.

  • SKILL.md
  • metadata.json
  • references/ork-delta.md
  • rules/_sections.md
  • rules/_template.md
  • rules/color-system.md
  • rules/css-cascade-layers.md
  • rules/design-system-components.md
  • rules/design-system-spacing.md
  • rules/design-system-states.md
  • rules/design-system-tokens.md
  • rules/design-system-typography.md
  • rules/empty-states.md
  • rules/forms-react-hook-form.md
  • rules/forms-validation-zod.md
  • rules/shadcn-v4-styles.md
  • rules/storybook-component-docs.md
  • rules/tailwind-v4-patterns.md
  • rules/typography-thresholds.md
  • … and 9 more

Open the folder on GitHubat commit 0ef71d2

Compare with similar skills

UI Components next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

UI Components compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
UI Components this skillyonatangross/orchestkit289—~2.9kAutomated safety check: PassMIT
UI StylingOhh-889/skyroc79513 repos~2.5kAutomated safety check: PassMIT
Ss Learnbitjaru/styleseed972—~1.3kAutomated safety check: PassMIT
Migrate Radix To BaseTheOrcDev/youtube-to-blog1802 repos~2.3kAutomated safety check: PassMIT
Styleseedbitjaru/styleseed972—~1.1kAutomated safety check: PassMIT
UI Design Systemtry-works/role-model118—~5kAutomated safety check: PassMIT

Similar skills

  • UI Styling

    Ohh-889/skyroc

    Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs.

    795 GitHub starsUsed in 13 repos~2.5k tokens
    Frontend & DesignAuto-check passed
  • Ss Learn

    bitjaru/styleseed

    Capture a human-approved UI design lesson as a privacy-minimized local StyleSeed candidate, review it, and prepare an opt-in share package without transmitting project code, prompts, screenshots, or…

    972 GitHub stars~1.3k tokensUpdated 7 days ago
    Frontend & DesignAuto-check passed
  • Migrate Radix To Base

    TheOrcDev/youtube-to-blog

    Migrates React projects and components from Radix UI to Base UI.

    180 GitHub starsUsed in 2 repos~2.3k tokens
    Frontend & DesignAuto-check passed
  • Styleseed

    bitjaru/styleseed

    Build, improve, or inspect UI with StyleSeed. An agent skill from bitjaru/styleseed.

    972 GitHub stars~1.1k tokensUpdated 7 days ago
    Frontend & DesignAuto-check passed
  • UI Design System

    try-works/role-model

    React UI component systems with TailwindCSS + Radix + shadcn/ui.

    118 GitHub stars~5k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Shadcn Tailwind UI

    LiarMTTT/TavernWeave

    Build, restyle, or review accessible React interfaces that use shadcn/ui, Radix UI primitives, and Tailwind CSS.

    150 GitHub stars~1.7k tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed

More from yonatangross/orchestkit

All 108 skills in this repo
  • API Design

    yonatangross/orchestkit

    API contract design for REST and GraphQL, covering resource shape, URL and header versioning with deprecation windows, RFC 9457 Problem Details error handling, and OpenAPI specs.

    289 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Architecture Decision Record

    yonatangross/orchestkit

    ADR templates in the Nygard format with context, decision, consequences, and alternatives.

    289 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Audit Full

    yonatangross/orchestkit

    Single-pass codebase analysis leveraging a 1M-token context window for comprehensive security scanning, architecture review, and dependency auditing.

    289 GitHub stars~3.5k tokensUpdated today
    Auto-check: notes
  • Code Review Playbook

    yonatangross/orchestkit

    Structured review processes, conventional comments, language-specific checklists, and feedback templates.

    289 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Create PR

    yonatangross/orchestkit

    Creates GitHub pull requests with pre-flight validation, conventional title formatting, and structured summary generation.

    289 GitHub stars~4.5k tokensUpdated today
    Auto-check: notes
  • Explore

    yonatangross/orchestkit

    Multi-angle codebase exploration spawning 3-5 parallel agents for code structure, data flow, architecture patterns, and health assessment.

    289 GitHub stars~3.9k tokensUpdated today
    Auto-check: notes

Questions about UI Components

What does UI Components do?

UI component library patterns for shadcn/ui and Radix Primitives. UI Components is an agent skill from yonatangross/orchestkit. UI component library patterns for shadcn/ui and Radix Primitives.

When should I use UI Components?

UI Components fits situations like: building accessible component libraries; customizing shadcn components; using Radix unstyled primitives; creating design system foundations.

How do I install UI Components in Claude Code?

Run `npx skills add yonatangross/orchestkit --skill ui-components -a claude-code`. Or copy the skill folder (src/skills/ui-components in yonatangross/orchestkit) into .claude/skills/ui-components in your project. Claude Code loads it when a task matches its description.

How do I install UI Components in Codex?

Run `npx skills add yonatangross/orchestkit --skill ui-components -a codex`. Or copy the skill folder (src/skills/ui-components in yonatangross/orchestkit) into .agents/skills/ui-components in your project. Codex loads it when a task matches its description.

Can I use UI Components in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yonatangross/orchestkit --skill ui-components -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ui-components, .gemini/skills/ui-components, .github/skills/ui-components and .opencode/skills/ui-components in your project.

What does UI Components need to run?

Going by SKILL.md and its folder, UI Components needs the command-line tools its instructions call (npx). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Read, Glob, Grep, WebFetch, WebSearch. Compatibility (from SKILL.md): Claude Code 2.1.277+..

Does UI Components access the network?

SKILL.md names 5 domains. As links in the text: ui.shadcn.com, radix-ui.com, cva.style, github.com and tanstack.com. This is read from the text; nothing was executed.

Is UI Components safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does UI Components use?

UI Components is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does UI Components use?

About 2.9k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 892 tokens, read only when the agent opens those files.

What are the alternatives to UI Components?

Skills that share tags, products or a category with UI Components: UI Styling (Ohh-889/skyroc, 795 stars), Ss Learn (bitjaru/styleseed, 972 stars), Migrate Radix To Base (TheOrcDev/youtube-to-blog, 180 stars) and Styleseed (bitjaru/styleseed, 972 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains UI Components?

yonatangross (a GitHub user) maintains it in yonatangross/orchestkit, which has 289 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on October 7, 2026.

Source: yonatangross/orchestkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.