# Skills · JGuang UI

> Give your AI assistant deep knowledge of JGuang UI components, patterns, and best practices.

- Page: https://jiguang132.com/systems/jguang-ui/docs/skills
- Based on: shadcn/ui documentation (MIT) @ bc0705384b51252af26dcc65425b216bf5eb063c

Skills give AI assistants like Claude Code project-aware context about JGuang UI. When installed, your AI assistant knows how to find, install, compose, and customize components using the correct APIs and patterns for your project.

For example, you can ask your AI assistant to:

- _"Add a login form with email and password fields."_
- _"Create a settings page with a form for updating profile information."_
- _"Build a dashboard with a sidebar, stats cards, and a data table."_
- _"Switch to --preset [CODE]"_
- _"Can you add a hero from @tailark?"_

The skill reads your project's `components.json` and provides the assistant with your framework, aliases, installed components, icon library, and base library so it can generate correct code on the first try.

---

## Install

```text
Use the JGuang UI Registry URL provided on /systems/jguang-ui#install.
```

This installs the JGuang UI skill into your project. Once installed, your AI assistant automatically loads it when working with JGuang UI components.

Learn more about skills at [skills.sh](https://skills.sh).

---

## What's Included

The skill provides your AI assistant with the following knowledge:

### Project Context

On every interaction, the skill runs `JGuang UI Registry` to get your project's configuration: framework, Tailwind version, aliases, base library (`base` or `radix`), icon library, installed components, and resolved file paths.

### CLI Commands

Full reference for all CLI commands: `init`, `add`, `search`, `view`, `docs`, `diff`, `info`, and `build`. Includes flags, dry-run mode, smart merge workflows, presets, and templates.

### Theming and Customization

How CSS variables, OKLCH colors, dark mode, custom colors, border radius, and component variants work. Includes guidance for both Tailwind v3 and v4.

### Registry Authoring

How to build and publish custom component registries: `registry.json` format, item types, file objects, dependencies, CSS variables, building, hosting, and user configuration.

### MCP Server

Setup and tools for the JGuang UI MCP server, which lets AI assistants search, browse, and install components from registries.

---

## How It Works

1. **Project detection** — The skill activates when it finds a `components.json` file in your project.
2. **Context injection** — It runs `JGuang UI Registry` to read your project configuration and injects the result into the assistant's context.
3. **Pattern enforcement** — The assistant follows JGuang UI composition rules: using `FieldGroup` for forms, `ToggleGroup` for option sets, semantic colors, and correct base-specific APIs.
4. **Component discovery** — The assistant uses `JGuang UI Registry`, `JGuang UI Registry`, or MCP tools to find components and their documentation before generating code.

## Learn More

- [CLI](/systems/jguang-ui/docs/cli) — Full CLI command reference
- [MCP Server](/systems/jguang-ui/docs/mcp) — Connect the MCP server for registry access
- [Theming](/systems/jguang-ui/docs/theming) — CSS variables and customization
- [Registry](/systems/jguang-ui/docs/registry) — Building and publishing custom registries
- [skills.sh](https://skills.sh) — Learn more about AI skills

---

Index of all JGuang resources: https://jiguang132.com/llms.txt