Agent skill

Shark UI

by sharkui-inc in sharkui-inc/shark-ui

Shark UI skill for the Ark UI–based shadcn-style registry. An agent skill from sharkui-inc/shark-ui.

MITAuto-check passedFrontend & Design

Install Shark UI

skills CLI
$ npx skills add sharkui-inc/shark-ui --skill shark-ui -a claude-code

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

GitHub CLI
$ gh skill install sharkui-inc/shark-ui shark-ui --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/sharkui-inc/shark-ui.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/shark-ui .claude/skills/shark-ui && 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
shark-ui
GitHub stars
192
Token cost
~2.4k tokens
SKILL.md length
858 words
Files
94 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Shark UI skill for the Ark UI–based shadcn-style registry. An agent skill from sharkui-inc/shark-ui.

  • Works in 4 steps: Use existing components first. Prefer… → Compose, don’t reinvent. Settings-style… → Built-in variants before custom classes.… → …
  • Debugging components (overlays
  • SKILL.md covers What this skill is for, Principles, Source of truth and Out of scope, plus 7 more sections
  • Calls npx, pnpm and bunx

What it does

Shark UI is an agent skill from sharkui-inc/shark-ui. Shark UI skill for the Ark UI–based shadcn-style registry. Use when implementing or debugging components (overlays, menus, popovers, sheets, dialogs), collection-driven controls (combobox, select, list patterns), Field/forms, sidebar or chart docs patterns, Tailwind v4 tokens, or migrating Radix/shadcn examples to Shark. Also applies when using the shadcn CLI with @shark/, components.json, or registry-style add/search/diff workflows.

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 95 other files, including reference files (for example `references/cli.md`, `references/component-registry.md` and `references/primitives/accordion.md`). Compatibility notes: Requires Tailwind CSS v4 and @ark-ui/react. Designed for React projects using the Shark UI registry (shadcn-style workflow).

It sits in Frontend & Design, covering Design systems. It works with shadcn/ui and Tailwind CSS. The repository describes itself as: Beautifully designed components built with Ark UI. The licence is MIT.

When your agent uses it

  • Debugging components (overlays
  • Collection-driven controls (combobox
  • Chart docs patterns
  • Tailwind v4 tokens

Example prompts

  • “/shark-ui”

Requirements

  • Node.js
  • Compatibility (from SKILL.md): Requires Tailwind CSS v4 and @ark-ui/react. Designed for React projects using the Shark UI registry (shadcn-style workflow).

Workflow steps

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

  1. Use existing components first. Prefer Shark primitives and registry/react/examples/ before custom UI. Use references/component-registry.md.
  2. Compose, don’t reinvent. Settings-style flows combine documented parts (e.g. Tabs + Card + Field); dashboards use Sidebar, Table, charts…
  3. Built-in variants before custom classes. variant, size, and semantic tokens before re-styling primitives (see references/rules/styling.md).
  4. Semantic colors. bg-primary, text-muted-foreground, border-input — not raw palette utilities for product UI.

What it can do on your machine

Read from SKILL.md and the folder at commit d43c3c2. 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:

    • npx
    • pnpm
    • bunx

    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):

    • ark-ui.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

    Requires Tailwind CSS v4 and @ark-ui/react. Designed for React projects using the Shark UI registry (shadcn-style workflow).

    From compatibility in the SKILL.md frontmatter.

Context cost

Shark UI loads about 2.4k tokens when it runs, and up to ~62k if it reads all its reference files. Until then it costs about 113 tokens; SKILL.md has 858 words of instructions outside code blocks.

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

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 sharkui-inc/shark-ui at commit d43c3c2, republished under its MIT licence (© sharkui-inc). 858 words, ~2,352 tokens.

Download SKILL.mdSave it as .claude/skills/shark-ui/SKILL.md (or your agent's skills folder). This skill also uses 93 other files; get the full folder from GitHub.
name
shark-ui
description
Shark UI skill for the Ark UI–based shadcn-style registry. Use when implementing or debugging components (overlays, menus, popovers, sheets, dialogs), collection-driven controls (combobox, select, list patterns), Field/forms, sidebar or chart docs patterns, Tailwind v4 tokens, or migrating Radix/shadcn examples to Shark. Also applies when using the shadcn CLI with `@shark/*`, `components.json`, or registry-style add/search/diff workflows.
compatibility
Requires Tailwind CSS v4 and @ark-ui/react. Designed for React projects using the Shark UI registry (shadcn-style workflow).

Shark UI

Shark UI is a component registry built on Ark UI with a shadcn-like developer experience (npx shadcn@latest add @shark/<component>).

Run CLI examples with the project’s package runner (npx shadcn@latest, pnpm dlx shadcn@latest, or bunx shadcn@latest) — match packageManager / team convention.

What this skill is for

Use this skill to:

  • pick the right Shark primitive(s) for a UI task
  • write correct usage code (imports, composition, props) aligned to Ark UI patterns wrapped by Shark
  • avoid assuming Radix/shadcn APIs without checking Shark docs and examples
  • use registry examples as the primary “how it fits together” reference

Principles

  1. Use existing components first. Prefer Shark primitives and registry/react/examples/ before custom UI. Use references/component-registry.md.
  2. Compose, don’t reinvent. Settings-style flows combine documented parts (e.g. Tabs + Card + Field); dashboards use Sidebar, Table, charts — follow in-repo examples.
  3. Built-in variants before custom classes. variant, size, and semantic tokens before re-styling primitives (see references/rules/styling.md).
  4. Semantic colors. bg-primary, text-muted-foreground, border-input — not raw palette utilities for product UI.

Source of truth

  • Component docs: content/docs/components/*.mdx
  • Registry examples: registry/react/examples/<component>/example-*.tsx
  • Implementations: registry/react/components/<component>.tsx
  • Published registry items: public/r/<name>.json (built from registry/manifest/<name>.ts)
  • LLM-oriented routes: app/(llms)/ and lib/llms.ts
  • Repository conventions: AGENTS.md

Out of scope

  • Next.js app routing, marketing pages, and non-registry app code unless the user explicitly asks.
  • Hand-editing generated public/r/*.json unless explicitly requested.

Critical rules

These rules are always enforced for Shark output. Each section links to longer guidance with Incorrect/Correct patterns where applicable.

Styling & Tailwind → references/rules/styling.md
  • className for layout, not ad-hoc reskinning — prefer variants and semantic tokens on primitives.
  • No space-x-* / space-y-*. Use flex / grid + gap-*.
  • size-* when width and height match — prefer over paired w-* / h-* for icons and square controls.
  • truncate shorthand — not overflow-hidden text-ellipsis whitespace-nowrap.
  • No manual dark: palette pairs when semantic tokens cover the case.
  • cn() from @/lib/utils for conditional or merged classes.
  • No manual z-index on overlays — Dialog, Sheet, Drawer, AlertDialog, Menu, ContextMenu, Popover, Tooltip, HoverCard, etc. own stacking.
Forms & inputs → references/rules/forms.md
  • FieldGroup + Field for form layout — not raw div + space-y-*.
  • InputGroup + InputGroupInput / InputGroupTextarea — not raw Input / Textarea inside a group.
  • Addons — actions beside inputs use InputGroup + InputGroupAddon patterns from docs.
  • Small option sets (2–7) — prefer ToggleGroup + ToggleGroupItem over looping Button with manual active styling.
  • FieldSet + FieldLegend for grouped checkboxes/radios — see Field docs.
  • Validation — invalid on Field, it will be passed to the control automatically; disabled patterns per forms guide.
Forms & validation → references/rules/forms.md
Component structure & composition → references/rules/composition.md
  • Items inside the correct parent — follow each primitive’s anatomy (e.g. list rows inside collection/list parts as documented).
  • Triggers — use asChild with a single child (Button, a) per Shark patterns; do not use render={...} on triggers (see references/rules/migration.md).
  • Overlays need titles — DialogTitle, SheetTitle, etc. for a11y; className="sr-only" when visually hidden.
  • Compound components — use exported parts (CardHeader, TabsList + TabsTrigger, etc.) as in MDX, not one blob in a single slot unless the primitive is intentionally minimal.
  • TabsTrigger inside TabsList — never bare triggers under Tabs root.
  • Avatar + AvatarFallback — always provide a fallback for failed images.
Use components, not one-off markup
  • Prefer Alert, Separator, Skeleton, Badge (and other primitives) over bespoke styled divs when the use case matches docs.
  • Toasts — follow Shark toast / docs patterns; do not hand-roll notification DOM unless required.
Show full SKILL.md (340 more words)Show less
Icons
  • Follow AGENTS.md and references/rules/styling.md for decorative icons (aria-hidden, sizing in examples).
  • In product UI, match the icon approach used in the same component’s registry examples and MDX.
Shark-specific (always)
  • Do not invent Shark or Ark APIs — confirm from MDX + registry/react/components/<name>.tsx.
  • Combobox (and similar): useFilter + useListCollection, collection prop, filter(inputValue) from onInputValueChange, collection.items.map(...) in the list (AGENTS.md).
  • Select / listbox with collections: createListCollection / useListCollection as in examples.
  • Charts: ChartTooltip with content={(props) => <ChartTooltipContent {...props} />}; do not stub tooltip props; optional accessibilityLayer={false} for static previews (AGENTS.md).
  • Sidebar doc previews: absolute inset-0 overflow-hidden, Sidebar with className="absolute", h-full on SidebarProvider, native overflow-y-auto when ScrollArea breaks layout (AGENTS.md).

Component discovery

Consult references/component-registry.md for the full list and links to ./references/primitives/<name>.md.

Usage workflow

  1. Identify intent (overlay, form, collection control, chart, etc.).
  2. Open references/component-registry.md and the target ./references/primitives/<name>.md when present.
  3. Read content/docs/components/<name>.mdx for install, anatomy, API, Ark doc link.
  4. Open at least one registry/react/examples/<component>/example-*.tsx.
  5. If behavior is unclear, read registry/react/components/<component>.tsx for Ark imports and prop passthrough.
  6. In consumer apps, avoid re-adding components already under resolvedPaths.
  7. Self-check a11y, controlled vs uncontrolled state, SSR/lazy-mount defaults, and Critical rules above.
Updating / diffing installs

When merging upstream CLI output with local edits, use npx shadcn@latest add @shark/<component> --dry-run and --diff per file before overwriting; never --overwrite without explicit user approval. See references/cli.md.

Installation reference

See references/cli.md.

bash
npx shadcn@latest add @shark/<component>

High-composition primitives

Read these guides first when touching overlays, collections, or app chrome:

  • ./references/primitives/dialog.md
  • ./references/primitives/sheet.md
  • ./references/primitives/menu.md
  • ./references/primitives/context-menu.md
  • ./references/primitives/popover.md
  • ./references/primitives/select.md
  • ./references/primitives/combobox.md
  • ./references/primitives/field.md
  • ./references/primitives/sidebar.md

Detailed references

Output checklist

Before returning code:

  • imports and props match Shark docs and/or source
  • composition matches Ark patterns used in Shark (triggers, collection objects)
  • explicit type on buttons in forms; labels wired for controls
  • combobox/select examples use collection + filter patterns when applicable
  • Critical rules (styling, forms, composition, CLI) satisfied

© sharkui-inc, 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 93 other files (references) in skills/shark-ui of sharkui-inc/shark-ui.

  • SKILL.md
  • references/cli.md
  • references/component-registry.md
  • references/primitives/accordion.md
  • references/primitives/action-bar.md
  • references/primitives/alert-dialog.md
  • references/primitives/alert.md
  • references/primitives/announcement.md
  • references/primitives/aspect-ratio.md
  • references/primitives/autocomplete.md
  • references/primitives/avatar.md
  • references/primitives/badge.md
  • references/primitives/bottom-navigation.md
  • references/primitives/breadcrumb.md
  • references/primitives/button-group.md
  • references/primitives/button.md
  • references/primitives/calendar.md
  • references/primitives/card.md
  • references/primitives/carousel.md
  • … and 75 more

Open the folder on GitHubat commit d43c3c2

Compare with similar skills

Shark UI 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.

Shark UI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shark UI this skillsharkui-inc/shark-ui192—~2.4kAutomated safety check: PassMIT
UI StylingOhh-889/skyroc79513 repos~2.5kAutomated safety check: PassMIT
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
Ss Learnbitjaru/styleseed973—~1.3kAutomated 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
  • 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
  • Uithing

    BayBreezy/ui-thing

    Manages UI Thing components, prose, blocks, themes, shortcuts, docs, and MCP-driven workflows in Nuxt projects and in the UI Thing source repo.

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

Questions about Shark UI

What does Shark UI do?

Shark UI skill for the Ark UI–based shadcn-style registry. An agent skill from sharkui-inc/shark-ui. Shark UI is an agent skill from sharkui-inc/shark-ui. Shark UI skill for the Ark UI–based shadcn-style registry.

When should I use Shark UI?

Shark UI fits situations like: debugging components (overlays; collection-driven controls (combobox; chart docs patterns; tailwind v4 tokens.

How do I install Shark UI in Claude Code?

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

How do I install Shark UI in Codex?

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

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

What does Shark UI need to run?

Going by SKILL.md and its folder, Shark UI needs the command-line tools its instructions call (npx, pnpm and bunx). Our summary lists: Node.js. Compatibility (from SKILL.md): Requires Tailwind CSS v4 and @ark-ui/react. Designed for React projects using the Shark UI registry (shadcn-style workflow)..

Does Shark UI access the network?

SKILL.md names 1 domain. As links in the text: ark-ui.com. This is read from the text; nothing was executed.

Is Shark UI 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 Shark UI use?

Shark UI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Shark UI use?

About 2.4k tokens (SKILL.md is roughly 9.4k 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 60k tokens, read only when the agent opens those files.

What are the alternatives to Shark UI?

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

Who maintains Shark UI?

sharkui-inc (a GitHub user) maintains it in sharkui-inc/shark-ui, which has 192 GitHub stars. The repository was last updated on October 3, 2026.

Source: sharkui-inc/shark-ui on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.