Agent Skill
Teach your AI coding agent how to build with Avara UI. The skill is a few Markdown files: a workflow the agent follows (plan, decide, install, read, adapt, check) and the rules that stop it inventing props or hard-coding colours. It is free, needs no account, and works with or without the MCP server.
What the agent gets
- A workflow. Plan the page, decide which pieces to use, install them with the CLI, read each one's Markdown for its real props, adapt the sample data, then run a final check.
- A question before it picks. Where a section or component comes in several designs (the hero, the footer, tabs, tables and many more), the agent shows you every design with a live link and waits for your answer. Name one, or tell it to pick the best for you and it will choose and say why.
- A searchable index.
https://avaraui.com/agent/components.jsonlists every component and website section with its summary, install command and Markdown URL, so an agent can pick by what a page does without a search server. - Rules. Theme tokens instead of hard-coded colours, one animation library per component, no
next/*imports, and respect forprefers-reduced-motion.
Requirements
- A project that uses shadcn/ui and Tailwind CSS. See Installation if it does not yet.
- One of the agents below: Claude Code, Cursor, GitHub Copilot in VS Code, Codex or OpenCode.
The skill is not an npm package, so there is nothing to npm install. It is a set
of text files added to your project, and it works the same whether the project
uses npm, pnpm, yarn or bun, on macOS, Linux or Windows. Your package manager
only matters later, when the agent installs components, and the skill tells it to
use yours.
Install the skill
Choose your agent. Each tab has the ways to install it. Ask your agent is the
easiest: you paste one prompt and the agent does the rest on any system.
shadcn CLI (Claude Code and Cursor) is the same shadcn add command you use for
components. Manual is one command, or one block to paste, if you prefer to do
it yourself.
Claude Code reads skills from .claude/skills/. It loads SKILL.md when a task matches its description, and opens the other files only when it needs them.
Paste this into your agent. It downloads the files and puts them in the right folder, on any system.
Check that it worked. Look in .claude/skills/ for the skill folder. Then start a new Claude Code session in the project, because skills are read when a session starts. Ask "Using @avara-ui, add a pricing section": the agent should plan the page and check the component index before writing any markup.
Update or remove. To update, install again (add --overwrite to the shadcn command): the files are replaced with the current version. To remove, delete the skill folder.
The files are plain text, so read them before you add them to a repository. They are generated from this site's own registry, so they only name components that exist.
Troubleshooting
nodeis not recognised, orfetch is not defined. The manual command needs Node.js 18 or newer. Update it, or use the shadcn CLI or "Ask your agent" tab instead.- "Skipped 1 file" from the shadcn command. The files are already there and identical, or you are updating: add
--overwriteto replace them. - A 404 or a blocked download. A proxy or firewall may be stopping the request. Use the file links under the manual command and save each file yourself.
- The agent ignores it. Check that the files sit in the project root, not a subfolder, and start a new session.
Use it
There is nothing to register. @avara-ui is listed in the shadcn registry directory, so the shadcn CLI finds it by name. Describe the interface in plain language and name @avara-ui so the agent looks in the right place:
- "Using @avara-ui, build a pricing page with a hero, the plans and an FAQ."
- "Add a @avara-ui data table of orders with sorting and pagination, wired to
/api/orders." - "Use @avara-ui to add a command palette and a dock to this app shell."
- "Replace this footer with the @avara-ui footer, keeping our links."
If the CLI ever answers "Unknown registry", your shadcn CLI is older than the directory lookup. Update it, or add the registry to the project once:
How the workflow runs
- Plan. The agent writes the page's sections and states (empty, loading, error) before any code.
- Decide. It searches the index or
https://avaraui.com/llms.txtand matches by summary. If nothing fits, it composes the screen from smaller components. For each section that comes in several designs, it asks you which one first, with a live link for every option, unless you already named one. - Install. It runs
npx shadcn@latest add @avara-ui/name --yes, or the same command withpnpm dlx,yarn dlxorbunxif your project uses another package manager. - Read. It fetches the item's Markdown for the props and import path.
- Adapt. It swaps in your data and keeps the component's structure and styling.
- Check. It runs the checklist: tokens only, keyboard access, dark mode, reduced motion, and a passing build.
Does the agent ask before it picks a design?
Yes, when a section has several designs. It lists each one with what it suits and a link to see it live, and installs nothing until you answer. In a client with a click-to-pick question tool (Claude Code, for one) you answer by clicking: a group first when there are many designs, then the design, or "Pick the best one for me". Reply with a design's name, or "pick the best one for me": then it chooses from each design's best-for and avoid-if notes against your brief, tells you which and why, and gives the link so you can swap. A section with one design is installed without a question. The rule lives in variants.md, one of the skill's files.
Do I need the skill if I use the MCP server?
No, but they work well together. The MCP server lets an agent browse and install from the registry. The skill tells it how to choose, what to read before writing code, and what to check afterwards.
Which agents can use it?
Claude Code and Cursor read the files directly. Any agent that reads AGENTS.md
(Codex, OpenCode, Copilot and others) gets the short block instead, which links
to the full workflow. An agent that can fetch URLs can also read the skill straight from this site: the
block above links to it.
Is the skill free?
Yes. It is part of the MIT-licensed Avara UI project, with no account, license key or API key. The components it points to are free as well.
Next steps
- MCP server — connect an agent to the registry
- Installation — set up a project for Avara UI
- All components — browse the library