beui-pro — Claude Code skill: what it does, how to install
Inspects, installs, and composes premium React blocks from beUI Pro using an authenticated MCP endpoint or the shadcn registry.
MIT 172 installs ★ 1,994 updated 2026-10-24
npx skills add starc007/ui-components --skill beui-pro -a claude-codeWhat beui-pro does
The skill teaches coding agents to query the live beUI Pro catalog instead of guessing slugs. It connects either via authenticated MCP at https://mcp.beui.dev/pro/mcp using OAuth or via direct shadcn CLI calls backed by BEUI_PRO_TOKEN.
Before writing files, the agent inspects the app layout and checks block dependencies with get_component or shadcn view. Selected sections—such as navbars, hero sections, and pricing tables—are merged directly into the project structure.
Without an authenticated MCP session or an exported BEUI_PRO_TOKEN, the agent cannot fetch private component code.
What it helps with
- Install licensed beUI Pro React sections into Next.js apps
- Inspect component dependencies and props prior to installation
- Configure the
@beui-proprivate registry insidecomponents.json - Compose matching landing page sections from hero to footer
Example prompts for the agent
- Find an active beUI Pro hero section and install it into my page
- Inspect
@beui-pro/pricing-cardbefore installing its dependencies - Configure
components.jsonfor the@beui-proregistry and install a navbar
How to install beui-pro
1Skills CLI (Vercel)
npx skills add starc007/ui-components --skill beui-pro -a claude-code2Manually: put the files in place
~/.claude/skills/beui-pro/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/beui-pro/
1Skills CLI (Vercel)
npx skills add starc007/ui-components --skill beui-pro -a codex2Manually: put the files in place
.agents/skills/beui-pro/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add starc007/ui-components --skill beui-pro -a cursor2Manually: put the files in place
.cursor/skills/beui-pro/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install starc007/ui-components skills/beui-pro2Manually: put the files in place
.github/skills/beui-pro/SKILL.md1Skills CLI (Vercel)
npx skills add starc007/ui-components --skill beui-pro -a gemini-cli2Platform CLI
gemini skills install https://github.com/starc007/ui-components --path skills/beui-proManually: put the files in place
.devin/skills/beui-pro/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add starc007/ui-components --skill beui-pro -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about beui-pro
How to install beui-pro in Claude Code?
Run npx skills add starc007/ui-components --skill beui-pro -a claude-code in your terminal. This creates ~/.claude/skills/beui-pro/SKILL.md.
What does beui-pro do?
It guides the assistant through discovering, inspecting, and installing licensed beUI Pro React blocks via MCP or the shadcn CLI.
What credentials does beui-pro require?
You need an active license, supplied either via an authenticated MCP link at https://mcp.beui.dev/pro/mcp or through the BEUI_PRO_TOKEN environment variable for CLI installs.
Source text
SKILL.md · MIT
---
name: beui-pro
description: Choose, inspect, install, and compose licensed beUI Pro premium React blocks through authenticated MCP or the shadcn registry. Use when building or improving landing pages with beUI Pro, installing @beui-pro items, selecting premium heroes, features, pricing, social proof, CTAs, navigation, footers, or other page sections, or adapting installed Pro source inside a React or Next.js project.
---
# beUI Pro
Use the customer's live licensed beUI Pro catalog as the source of truth. Discover current items at runtime, install only the blocks the project needs, then compose and adapt the source.
## Choose an access path
Follow the current [agent access documentation](https://pro.beui.dev/components/agents) for connection instructions.
- **MCP:** Use an existing authenticated connection to `https://mcp.beui.dev/pro/mcp`. OAuth-capable clients open beUI's approval page, where the user enters their license key. Clients with custom headers can also use bearer authentication. A working MCP connection does not require a separate token in the agent's shell.
- **Direct registry or shadcn CLI:** Follow the [installation documentation](https://pro.beui.dev/components/installation). This path requires `BEUI_PRO_TOKEN` in the command environment and private registry configuration for namespaced CLI commands.
Prefer an available authenticated MCP connection. Do not replace it with token setup just because the shell has no token.
## Protect access
- Require `BEUI_PRO_TOKEN` only for direct registry requests or CLI installs, not for authenticated MCP calls.
- Never print, paste, commit, or write the token into source files.
- Never accept a token copied into the user's prompt. For OAuth, the user enters the key only on beUI's approval page.
- If MCP authentication is missing or expired, use the client's native authentication flow. Never extract its stored OAuth credentials for shell commands.
- If using the direct registry path and the token is unavailable, ask the user to configure it. Do not replace a requested Pro block with an approximation.
- If the live catalog cannot be fetched, do not present remembered, documented, or locally inferred slugs as the current catalog.
- On `401`, restore authentication for the chosen path. Treat `404` as a stale or incorrect install slug and refresh the catalog.
For direct registry access only, check token presence without revealing its value:
```bash
test -n "$BEUI_PRO_TOKEN" && echo "beUI Pro token is configured"
```
## Configure the registries (direct CLI only)
Skip private registry setup when installing source returned by MCP.
Inspect the project's existing `components.json` before editing it. Preserve its aliases and settings. Ensure both namespaces exist because Pro blocks can depend on public beUI primitives:
```jsonc
{
"registries": {
"@beui": "https://beui.dev/r/{name}.json",
"@beui-pro": {
"url": "https://pro.beui.dev/r/{name}.json",
"headers": {
"Authorization": "Bearer ${BEUI_PRO_TOKEN}"
}
}
}
}
```
Merge this into the existing file rather than replacing it. Do not create or modify a secret file unless the user explicitly asks.
## Workflow
### 1. Understand the project
Read the existing app before choosing blocks. Identify:
- framework and package manager
- requested page or section
- existing typography, theme tokens, spacing, and layout shell
- blocks already installed
- required states, data, and interactions
Prefer a coherent page composition over selecting blocks independently.
### 2. Fetch the live catalog
**MCP:** Use `list_components` or `search_components` on the Pro connection. Choose an exact slug from the live response. Use the client's current tool schemas.
**Direct registry:** Fetch the authenticated registry instead of relying on remembered slugs:
```bash
curl -fsS \
-H "Authorization: Bearer ${BEUI_PRO_TOKEN}" \
https://pro.beui.dev/r/registry.json
```
Choose only from `items[].name`. This endpoint is the complete list of currently installable Pro blocks and components.
Use the grouped index when the request needs broader discovery:
```bash
curl -fsS \
-H "Authorization: Bearer ${BEUI_PRO_TOKEN}" \
https://pro.beui.dev/r
```
Use names and descriptions to match the user's intent. Do not invent or shorten install slugs.
### 3. Select intentionally
Map the page brief to the smallest useful set of sections. A typical landing page may need one item from each relevant family:
1. navbar
2. hero
3. trust or social proof
4. features or content
5. pricing when applicable
6. CTA
7. footer
Do not install the whole catalog unless the user explicitly requests it. Avoid combining blocks with conflicting visual directions. Preserve the strongest aesthetic of each selected block while aligning shared typography, spacing, and theme tokens across the page.
The Pro MCP catalog exposes the installable items from `/r/registry.json`. For full standalone templates, follow the template's documented entitlement and download flow; do not fabricate an `@beui-pro` template command.
### 4. Inspect before installing
**MCP:** Call `get_component` with the selected slug. Inspect its complete source files, targets, package dependencies, registry dependencies, props, and named exports.
**Direct registry:** Inspect each selected item through the CLI:
```bash
npx shadcn@latest view @beui-pro/<slug>
```
Use the project's package runner when appropriate:
```bash
pnpm dlx shadcn@latest view @beui-pro/<slug>
bunx --bun shadcn@latest view @beui-pro/<slug>
```
Re-fetch the live catalog if inspection returns `404`. Restore authentication for the chosen access path if it returns `401`.
### 5. Install the selected source
**MCP:** Install the complete source returned by `get_component`:
- Map returned files to the project's paths and aliases. Keep all writes within the project.
- Compare existing files before applying changes. Preserve shared helpers and local modifications.
- Install missing package dependencies with the project's package manager.
- Resolve registry dependencies: fetch licensed Pro dependencies through MCP and obtain public dependencies through their public MCP or registry. Include transitive dependencies.
- If source or dependency metadata is incomplete, retrieve the missing data before continuing. Do not reconstruct a requested component from memory.
The `install` and `requiredRegistries` fields, and `get_install_command`, describe the separate shadcn CLI path. They do not make private registry setup a prerequisite for using the returned source. MCP OAuth does not authenticate a separately launched shadcn process.
**Direct registry:** Install through the configured namespace:
```bash
npx shadcn@latest add @beui-pro/<slug>
```
The registry can install public `@beui` dependencies automatically. Keep those generated dependencies and helpers instead of copying or rebuilding them.
### 6. Compose and adapt
Read every generated file before using it. Then:
- import its named exports from the installed paths
- connect real copy, links, images, and data
- preserve accessibility and reduced-motion behavior
- use existing semantic theme tokens
- make layout-level changes with `className` and composition first
- change block internals only when the product requirement needs it
- keep all work inside the user's project
Do not recreate a low-level motion primitive when the installed block already depends on a public beUI primitive.
### 7. Verify
Run the project's relevant typecheck and lint commands. Render the changed route at desktop and mobile widths, check interaction and reduced-motion behavior, and confirm there is no overflow or hydration error.
Report which Pro slugs were installed and which files were adapted.
## Common requests
- For “build a landing page,” select a complete but restrained section sequence, install each exact slug, and compose it in the existing route.
- For “add a pricing section,” search pricing entries, inspect the closest variants, install one, and connect the real plans.
- For “use beUI Pro components,” inspect the current UI first and prefer relevant Pro blocks over custom replacements.
- For “show me what Pro has,” use the live MCP or registry catalog and summarize matching items without exposing source or the token.
© starc007 · MIT · starc007/ui-components