Agent skill

Shadcn

by ItsWendell in ItsWendell/palot

A skill your agent uses when adding, updating, composing, or debugging source components managed by shadcn; changing apps/desktop/components.json, registries, or presets; or running the shadcn CLI.

MITAuto-check passedFrontend & Design

Install Shadcn

skills CLI
$ npx skills add ItsWendell/palot --skill shadcn -a claude-code

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

GitHub CLI
$ gh skill install ItsWendell/palot shadcn --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/ItsWendell/palot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/shadcn .claude/skills/shadcn && 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
shadcn
GitHub stars
191
Token cost
~795 tokens
SKILL.md length
353 words
Files
17 (incl. assets)
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when adding, updating, composing, or debugging source components managed by shadcn; changing apps/desktop/components.json, registries, or presets; or running the shadcn CLI.

  • Works in 4 steps: Run vp exec -- shadcn add --dry-run to… → Run vp exec -- shadcn add --diff for… → Apply upstream changes while preserving… → …
  • Debugging source components managed by shadcn
  • SKILL.md covers Choose the work, Updating components, Project rules and References
  • Calls pnpm

What it does

Shadcn is an agent skill from ItsWendell/palot. Use when adding, updating, composing, or debugging source components managed by shadcn; changing apps/desktop/components.json, registries, or presets; or running the shadcn CLI. Do not use for cosmetic layout or styling changes that only add classes around existing primitives.

Its SKILL.md is about 800 tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including assets (for example `LICENSE.md`, `NOTICE.md` and `agents/openai.yml`).

It sits in Frontend & Design, covering Design systems. It works with shadcn/ui. The repository describes itself as: Just another desktop client for OpenCode 2. Manage projects, sessions, parallel agents, requests, and changes on Linux and macOS. The licence is MIT.

When your agent uses it

  • Debugging source components managed by shadcn
  • Changing apps/desktop/components.json
  • Running the shadcn CLI
  • Cosmetic layout

Example prompts

  • “/shadcn”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Run vp exec -- shadcn add --dry-run to list affected files.
  2. Run vp exec -- shadcn add --diff for each customized file.
  3. Apply upstream changes while preserving local behavior and imports.
  4. Use --overwrite only when the user explicitly authorizes replacing local changes.

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    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.

Context cost

Shadcn loads about 795 tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 353 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~71
When it runs · the whole SKILL.md, loaded when a task matches
~795

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from ItsWendell/palot at commit 5b71bf9, republished under its MIT licence (© ItsWendell). 353 words, ~795 tokens.

Download SKILL.mdSave it as .claude/skills/shadcn/SKILL.md (or your agent's skills folder). This skill also uses 16 other files; get the full folder from GitHub.
name
shadcn
description
Use when adding, updating, composing, or debugging source components managed by shadcn; changing apps/desktop/components.json, registries, or presets; or running the shadcn CLI. Do not use for cosmetic layout or styling changes that only add classes around existing primitives.
slash
false

shadcn/ui in Palot

Palot pins the shadcn CLI in apps/desktop. Run it from that workspace through Vite+:

sh
vp exec -- shadcn info --json
vp exec -- shadcn docs <component>

Do not use npx, pnpm dlx, bunx, or an @latest CLI. Preserve the repository pin and the aliases, Tailwind file, primitive base, icon library, and registries reported by info.

Choose the work

  • Existing-source fixes: inspect the component and relevant callers first. Use the local implementation as the contract; CLI discovery and external docs are unnecessary when that evidence answers the question.
  • Adding components or changing registry/configuration: read repository-root ../../../apps/desktop/components.json and run vp exec -- shadcn info --json from apps/desktop. Prefer existing local primitives and variants; use search or view when looking for a missing component.
  • Unclear APIs or upstream behavior: use vp exec -- shadcn docs <component> and fetch the relevant returned documentation. Reconcile it with the local source before applying it to customized components.
  • Upstream component updates: follow the preview workflow below.

Inspect changed imports and CSS where applicable, then follow the formatting and validation workflow in the development guide. Shadcn CLI edits bypass OpenCode's native formatter hook, so format those files explicitly while respecting the repository's exclusions.

Show full SKILL.md (169 more words)Show less

Updating components

Use the CLI rather than fetching upstream source manually:

  1. Run vp exec -- shadcn add <component> --dry-run to list affected files.
  2. Run vp exec -- shadcn add <component> --diff <file> for each customized file.
  3. Apply upstream changes while preserving local behavior and imports.
  4. Use --overwrite only when the user explicitly authorizes replacing local changes.

Project rules

  • Use semantic theme tokens rather than raw colors or manual dark-mode overrides.
  • Use gap-*, size-*, truncate, and cn() rather than equivalent verbose utilities.
  • Compose forms with FieldGroup and Field; put collection items inside their matching group.
  • Dialog-like surfaces require an accessible title.
  • Prefer shared components such as Alert, Empty, Separator, Skeleton, and Badge over hand-built equivalents.
  • Keep layout decisions in call sites and reusable visual behavior in component variants.

References

Read only the branch needed for the task:

  • Styling and Tailwind: rules/styling.md
  • Forms and validation: rules/forms.md
  • Component composition: rules/composition.md
  • Base UI versus Radix APIs: rules/base-vs-radix.md
  • Icons: rules/icons.md
  • Chat primitives: rules/chat.md
  • CLI commands: cli.md
  • Registries: registry.md
  • Presets and customization: customization.md

© ItsWendell, 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 16 other files (assets) in .agents/skills/shadcn of ItsWendell/palot.

  • SKILL.md
  • LICENSE.md
  • NOTICE.md
  • agents/openai.yml
  • assets/shadcn-small.png
  • assets/shadcn.png
  • cli.md
  • customization.md
  • evals/evals.json
  • mcp.md
  • registry.md
  • rules/base-vs-radix.md
  • rules/chat.md
  • rules/composition.md
  • rules/forms.md
  • rules/icons.md
  • rules/styling.md

Open the folder on GitHubat commit 5b71bf9

Compare with similar skills

Shadcn 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.

Shadcn compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shadcn this skillItsWendell/palot191—~795Automated safety check: PassMIT
UI StylingOhh-889/skyroc79513 repos~2.5kAutomated safety check: PassMIT
Shadcnsupabase/evals14442 repos~4.5kAutomated safety check: PassApache-2.0
Creative Tim UI Blockscreativetimofficial/ui12k—~2.1kAutomated safety check: NotesMIT
Cosscrafter-station/petdex4.2k—~1.4kAutomated safety check: PassMIT
Activepieces Design Systemactivepieces/activepieces25k—~3.6kAutomated safety check: PassCustom licence

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
  • Shadcn

    supabase/evals

    Official

    Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI.

    144 GitHub starsUsed in 42 repos~4.5k tokens
    Frontend & DesignAuto-check passed
  • Creative Tim UI Blocks

    creativetimofficial/ui

    Helps install, generate and review Creative Tim UI blocks: shadcn/ui-based React and Tailwind sections that follow a restrained, production-minded design philosophy.

    12k GitHub stars~2.1k tokensUpdated 6 mo ago
    Frontend & DesignAuto-check: notes
  • Coss

    crafter-station/petdex

    Helps implement coss UI components correctly. An agent skill from crafter-station/petdex.

    4.2k GitHub stars~1.4k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Activepieces Design System

    activepieces/activepieces

    Design system for Activepieces (open-source AI automation platform, "open source replacement for Zapier").

    25k GitHub stars~3.6k tokensUpdated today
    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…

    973 GitHub stars~1.3k tokensUpdated yesterday
    Frontend & DesignAuto-check passed

More from ItsWendell/palot

All 9 skills in this repo
  • Diffs

    ItsWendell/palot

    A skill your agent uses when changing Palot code, file, or diff rendering built on @pierre/diffs, including the Changes tab, file views, CodeView, parsing, selection, annotations, workers, or Shiki…

    191 GitHub stars~841 tokensUpdated 2 days ago
    Auto-check passed
  • Trees

    ItsWendell/palot

    A skill your agent uses when changing Palot file-tree behavior built on @pierre/trees, especially the Changes tab tree, selection, search, rename, drag and drop, Git status, or theme integration.

    191 GitHub stars~540 tokensUpdated 2 days ago
    Auto-check passed
  • Opencode Runtime

    ItsWendell/palot

    Check or update Palot's OpenCode CLI, client, protocol/schema and runtime contract.

    191 GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check passed
  • Test Palot Desktop

    ItsWendell/palot

    Test Palot's native Electron renderer with preload, IPC, and OpenCode integration.

    191 GitHub stars~1.9k tokensUpdated 2 days ago
    Auto-check passed
  • Palot Performance

    ItsWendell/palot

    Measure and improve Palot desktop runtime performance. An agent skill from ItsWendell/palot.

    191 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Opencode Coverage

    ItsWendell/palot

    Audit Palot's OpenCode 2 operation and event coverage, analyzer or baseline regressions, published contract-surface deltas, or reviewed baseline updates.

    191 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Shadcn

What does Shadcn do?

A skill your agent uses when adding, updating, composing, or debugging source components managed by shadcn; changing apps/desktop/components.json, registries, or presets; or running the shadcn CLI. Shadcn is an agent skill from ItsWendell/palot.json, registries, or presets; or running the shadcn CLI.

When should I use Shadcn?

Shadcn fits situations like: debugging source components managed by shadcn; changing apps/desktop/components.json; running the shadcn CLI; cosmetic layout.

How do I install Shadcn in Claude Code?

Run `npx skills add ItsWendell/palot --skill shadcn -a claude-code`. Or copy the skill folder (.agents/skills/shadcn in ItsWendell/palot) into .claude/skills/shadcn in your project. Claude Code loads it when a task matches its description.

How do I install Shadcn in Codex?

Run `npx skills add ItsWendell/palot --skill shadcn -a codex`. Or copy the skill folder (.agents/skills/shadcn in ItsWendell/palot) into .agents/skills/shadcn in your project. Codex loads it when a task matches its description.

Can I use Shadcn 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 ItsWendell/palot --skill shadcn -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/shadcn, .gemini/skills/shadcn, .github/skills/shadcn and .opencode/skills/shadcn in your project.

What does Shadcn need to run?

Going by SKILL.md and its folder, Shadcn needs the command-line tools its instructions call (pnpm).

Does Shadcn access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Shadcn 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. Review the folder before installing.

What licence does Shadcn use?

Shadcn is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Shadcn use?

About 795 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Shadcn?

Skills that share tags, products or a category with Shadcn: UI Styling (Ohh-889/skyroc, 795 stars), Shadcn (supabase/evals, 144 stars), Creative Tim UI Blocks (creativetimofficial/ui, 12k stars) and Coss (crafter-station/petdex, 4.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shadcn?

ItsWendell (a GitHub user) maintains it in ItsWendell/palot, which has 191 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 7, 2026.

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