Skip to content
Skills Library
Design & UX · Building & coding

components

/components

Use when building a frontend and the user wants a distinctive / animated / "wow" UI element in React + Tailwind - e.g. a laptop-opening-on-scroll, 3D tilt card, spotlight hero, animated beams/background, marquee, bento grid, interactive globe, meteor/particle background, shimmer button, or scroll/reveal motion. Fetches the showpiece component LIVE at build time from code libraries (Aceternity, Magic UI, Cult UI, ReactBits, 21st.dev) via their shadcn registry command (or WebFetch fallback), then adapts it to brand tokens. Also covers plain components (button, form, modal, table, etc.) as a fall

Licence
Apache-2.0
Last repository change
09.11.2026

Assessment and security

95/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene10 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
106
Scripts
56
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 09.11.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What to check before installing
  • 56 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: cli/bin/components-skill.js, cli/scripts/check-version-sync.js, cli/src/commands/add.js, cli/src/commands/list.js, cli/src/commands/search.js, cli/src/commands/tokens.js, cli/src/commands/update.js, cli/src/commands/verify.js

What it does and when to use it

Use when building a frontend and the user wants a distinctive / animated / "wow" UI element in React + Tailwind - e.g. a laptop-opening-on-scroll, 3D tilt card, spotlight hero, animated beams/background, marquee, bento grid, interactive globe, meteor/particle background, shimmer button, or scroll/reveal motion. Fetches the showpiece component LIVE at build time from code libraries (Aceternity, Magic UI, Cult UI, ReactBits, 21st.dev) via their shadcn registry command (or WebFetch fallback), then adapts it to brand tokens. Also covers plain components (button, form, modal, table, etc.) as a fall

Triggers from the description

wow
Original author description

Use when building a frontend and the user wants a distinctive / animated / "wow" UI element in React + Tailwind - e.g. a laptop-opening-on-scroll, 3D tilt card, spotlight hero, animated beams/background, marquee, bento grid, interactive globe, meteor/particle background, shimmer button, or scroll/reveal motion. Fetches the showpiece component LIVE at build time from code libraries (Aceternity, Magic UI, Cult UI, ReactBits, 21st.dev) via their shadcn registry command (or WebFetch fallback), then adapts it to brand tokens. Also covers plain components (button, form, modal, table, etc.) as a fall

How it works

  1. What this is
  2. Decision flow
  3. How to fetch live
  4. Rules
  5. Troubleshooting (fetch failed?)
  6. Limitations
  7. Maintenance
Original SKILL.md headings · 86 lines, 1,127 words
SKILL.md preview
---
name: components
description: Use when building a frontend and the user wants a distinctive / animated / "wow" UI element in React + Tailwind - e.g. a laptop-opening-on-scroll, 3D tilt card, spotlight hero, animated beams/background, marquee, bento grid, interactive globe, meteor/particle background, shimmer button, or scroll/reveal motion. Fetches the showpiece component LIVE at build time from code libraries (Aceternity, Magic UI, Cult UI, ReactBits, 21st.dev) via their shadcn registry command (or WebFetch fallback), then adapts it to brand tokens. Also covers plain components (button, form, modal, table, etc.) as a fallback. Triggers on "make it pop", "something flashy", "animated [X]", "like [cool site]", "build a [showpiece] section". NOT for non-React stacks. Inspiration galleries (Dribbble/godly) are visual reference only - never code.
---

# components

**Fetch flashy, proven, animated React+Tailwind components LIVE from code libraries instead of hand-writing complex motion.** User describes an effect → match it → pull the real component at build time → adapt to brand.

## What this is

- **PRIMARY: showpiece live-fetch.** Distinctive/animated components (laptop scroll, 3D card, beams, globe, marquee...) fetched live from code libraries via registry CLI / WebFetch.
- **FALLBACK: plain components.** Standard button/form/modal/table when no "wow" is asked.
- **SOURCE layer only.** After placing the component, hand off final polish/distinctiveness to `impeccable` / `frontend-design` **if installed** - both are optional sibling skills, not dependencies of this repo. See `references/handoff.md` for what to do when neither is available.
- **Galleries ≠ code.** Dribbble, godly.website, Awwwards = visual reference ONLY. Never fetch components from them.
- **Layout curation.** `layouts[]` are pre-composed arrangements (web sections or video beat patterns). `TASTE.md` is the required-reading standard for picking or building one - read it before selecting a layout.

## Decision flow

```
user wants a UI component (React + Tailwind)?
├─ is it a distinctive / animated / "wow" effect?
│   ├─ YES (primary path):
│   │   1. match the described effect → showpiece[] entry (name or aliases)
│   │   2. no direct match → search code_libraries[] live for the effect
│   │      (WebFetch the library's components page, find the closest)
│   │   3. FETCH LIVE (see references/live-fetch.md):
│   │      - preferred: run the entry's `ref` registry command
│   │        e.g. `npx shadcn@latest add "https://ui.aceternity.com/registry/macbook-scroll.json"`
│   │      - fallback: WebFetch / Playwright the page, extract the code
│   │   4. install listed `deps` (usually `motion` = framer-motion)
│   │   5. ADAPT: brand tokens + prefers-reduced-motion + responsive
│   │      (references/adaptation.md)
│   │   6. hand off polish → impeccable / frontend-design (optional, if installed)
│   └─ NO → fallback_basic[]: standard component, adapt to tokens.
```

## How to fetch live

1. Read `components.json`. Find the `showpiece` entry by name/alias, else pick a `code_libraries` source and search it live.
2. **Target project is Vue or Svelte, not React?** Check whether the matched entry has a `frameworks.vue` / `frameworks.svelte` object. If it does, use *its* `ref`/`fetch`/`library`/`license`/`deps` instead of the entry's top-level (React) ones - the rest of this flow is unchanged. If it doesn't, say so; don't improvise a port. Coverage today: all 9 ReactBits entries have both Vue (Vue Bits) and Svelte (Svelte Bits) variants; the Aceternity and Magic UI entries with a verified Inspira UI equivalent have Vue variants. Everything else is React-only.
3. **Show the user the registry command before running it** (it pulls code into their project).
4. Run `ref`. If `fetch.method` is `registry_item` (every Svelte Bits variant), `ref` is not a command: GET `fetch.url`, write each `files[].content` to its `target` with a leading `$lib/` resolved to `src/lib/`, and install its `dependencies[]`. No CLI places those files correctly yet (#66). If the registry shorthand fails (library changed it), open the `site` page, confirm the current command, retry. Last resort: WebFetch the page and write the code manually. (`ref` is the display form of the entry's `fetch` object; if you are writing tooling, read `fetch.url` / `fetch.cli` and never parse the command string.)
5. Install `deps`. Most need `motion` (framer-motion). 3D globe needs `cobe`; wavy bg needs `simplex-noise`. **`deps` is not optional detail**: it records peer dependencies the registry item itself does not declare, and the component will not compile without them (every Inspira UI variant needs `@inspira-ui/plugins` for `cn()`, which its registry JSON omits).
6. Adapt (mandatory - never raw): map demo colors to brand tokens, wrap motion in `prefers-reduced-motion`, check mobile.
7. Verify it compiles + renders (`npx components-skill@latest verify <file>` checks colors, the reduced-motion guard, a project-context typecheck, and a smoke-render in one go), then hand off to a quality skill if one is installed
   (`references/handoff.md`). Otherwise the adapted component is already the final output.

## Rules

- **Live-fetch from code libraries only.** `showpiece` + `code_libraries` are curated *pointers*; the actual code is fetched at build time so it stays current.
- **Galleries are visual-ref only** - no code lives there.
- **Never paste raw.** Adapt tokens + motion + responsive every time.
- **Respect motion accessibility.** Every animated component honors `prefers-reduced-motion`.
- **Check license per source.** Magic UI / Cult UI / ReactBits = MIT. Aceternity = free personal+commercial (verify). 21st.dev = per-component, verify before shipping; its registry endpoint also needs a 21st.dev account/API key, so use each entry's open-mirror `ref` or the page-fetch path.
- **Safety:** registry commands run code installs - show the command, prefer official namespaces, don't blindly run unknown-registry URLs.

## Troubleshooting (fetch failed?)

Registries change. Recover in this order - never leave the user stuck:

1. **Command 404 / "unknown registry"** → open the entry's `site` page, confirm the current command, retry. Make sure `shadcn@latest` is used (not an old pinned version).
2. **Still failing** → WebFetch the component's docs page, extract the code block, write the file(s) manually, install the listed `deps`.
3. **Code is behind JS/tabs** → use the `playwright` skill to read the rendered code panel.
4. **Network/registry down** → fall back to the closest `fallback_basic` entry or a hand-composed version, and tell the user the showpiece source is unreachable. Do not block the build on a dead registry.

> **No vendoring, by design:** `components` ships pointers only and never bundles upstream code, so when an upstream is unreachable the showpiece is temporarily unavailable. Degrade gracefully per step 4 (closest `fallback_basic`, or hand-compose) rather than erroring out. Staying pointer-only keeps the skill permanently clear of any redistribution licensing.

## Limitations

- **Primarily React + Tailwind**, and the target project must already be `shadcn`-initialised
  (has `components.json` + a registry-aware `npx shadcn` setup). Vue and Svelte support is
  narrow and per-entry, not general: see step 2 of "How to fetch live" for which showpieces
  carry a verified `frameworks.vue` / `frameworks.svelte` variant. Everything else, and
  plain HTML, is React-only.
- **No vendoring.** Showpieces are pointers fetched live; if an upstream registry endpoint
  changes or goes down, that showpiece is temporarily unavailable (see Troubleshooting)
  rather than silently served from a stale local copy.
- **21st.dev** entries route around the official registry (which needs an account/API key)
  via open mirrors or page-fetch - slightly more fragile than a direct `npx shadcn` call.
- **License compliance is per-source, not blanket.** `components.json` records each entry's
  license, but verifying it's still accurate before commercial redistribution is on the user
  (see [Sources & licenses](README.md#sources--licenses) / `ATTRIBUTION.md`).
- **Not a design-quality skill.** It sources and adapts a component; it doesn't judge whether
  the result fits the page's visual system - that's `impeccable` / `frontend-design`'s job.

## Maintenance

`showpiece`/`code_libraries` are pointers, so they rot slowly. Quarterly: confirm registry namespaces + library sites still resolve. Update `ref` patterns if a library changes its CLI. See `CONTRIBUTING.md`.
Files in this package (106)
  • .editorconfig 1 KB
  • .gitattributes 1 KB
  • .gitignore 1 KB
  • ATTRIBUTION.md 6 KB
  • CHANGELOG.md 15 KB
  • CODE_OF_CONDUCT.md 2 KB
  • CONTRIBUTING.md 9 KB
  • LICENSE 10 KB
  • README.md 16 KB
  • SECURITY.md 1 KB
  • SKILL.md 8 KB
  • TASTE.md 4 KB
  • components.json 62 KB
  • .github/CODEOWNERS 1 KB
  • .github/PULL_REQUEST_TEMPLATE.md 1 KB
  • .github/dependabot.yml 1 KB
  • .github/labeler.yml 1 KB
  • .github/ISSUE_TEMPLATE/bug_report.yml 1 KB
  • .github/ISSUE_TEMPLATE/config.yml 1 KB
  • .github/ISSUE_TEMPLATE/new_component.yml 2 KB
  • .github/workflows/build-agent-dirs.yml 3 KB
  • .github/workflows/cli-ci.yml 2 KB
  • .github/workflows/component-smoke-test.yml 6 KB
  • .github/workflows/deploy-gallery.yml 3 KB
  • .github/workflows/health-check.yml 2 KB
  • .github/workflows/label.yml 1 KB
  • .github/workflows/media-size.yml 2 KB
  • .github/workflows/validate.yml 1 KB
  • cli/PUBLISHING.md 2 KB
  • cli/README.md 11 KB
  • cli/package-lock.json 18 KB
  • cli/package.json 1 KB
  • cli/bin/components-skill.js 7 KB
  • cli/scripts/check-version-sync.js 2 KB
  • cli/src/commands/add.js 3 KB
  • cli/src/commands/list.js 4 KB
  • cli/src/commands/search.js 5 KB
  • cli/src/commands/tokens.js 13 KB
  • cli/src/commands/update.js 3 KB
  • cli/src/commands/verify.js 22 KB
  • cli/src/lib/dist.js 1 KB
  • cli/src/lib/layout.js 2 KB
  • cli/src/lib/manifest.js 4 KB
  • cli/test/add.test.js 4 KB
  • cli/test/list.test.js 4 KB
  • cli/test/search.test.js 6 KB
  • cli/test/tokens.test.js 9 KB
  • cli/test/update.test.js 6 KB
  • cli/test/verify.test.js 14 KB
  • docs/previews-audit.md 9 KB
  • docs/media/demo.gif 2,075 KB
  • docs/media/demo.mp4 2,112 KB
  • gallery/.gitignore 1 KB
  • gallery/components.json 1 KB
  • gallery/index.html 1 KB
  • gallery/package-lock.json 86 KB
  • gallery/package.json 1 KB
  • gallery/tsconfig.app.json 1 KB
  • gallery/tsconfig.json 1 KB
  • gallery/tsconfig.node.json 1 KB
  • gallery/vite.config.ts 1 KB
  • gallery/scripts/fetch-showpieces.mjs 12 KB
  • gallery/src/App.tsx 19 KB
  • gallery/src/index.css 4 KB
  • gallery/src/main.tsx 1 KB
  • gallery/src/demos/Demo3dCard.tsx 1 KB
  • gallery/src/demos/DemoAnimatedShinyText.tsx 1 KB
  • gallery/src/demos/DemoAurora.tsx 1 KB
  • gallery/src/demos/DemoBackgroundBeams.tsx 1 KB
  • gallery/src/demos/DemoBlurText.tsx 1 KB
  • gallery/src/demos/DemoCanvasFractalGrid.tsx 1 KB
  • gallery/src/demos/DemoCobeGlobeInteractive.tsx 1 KB
  • gallery/src/demos/DemoCountUp.tsx 1 KB
  • gallery/src/demos/DemoDecryptedText.tsx 1 KB
  • gallery/src/demos/DemoDock.tsx 1 KB
  • gallery/src/demos/DemoGlobe.tsx 1 KB
  • gallery/src/demos/DemoHyperspeed.tsx 1 KB
  • gallery/src/demos/DemoLetterGlitch.tsx 1 KB
  • gallery/src/demos/DemoMarquee.tsx 1 KB
  • gallery/src/demos/DemoMatrixText.tsx 1 KB
  • gallery/src/demos/DemoMeteors.tsx 1 KB
  • gallery/src/demos/DemoParticlesWebgl.tsx 1 KB
  • gallery/src/demos/DemoShaderLensBlur.tsx 1 KB
  • gallery/src/demos/DemoShimmerButton.tsx 1 KB
  • gallery/src/demos/DemoSplashCursor.tsx 1 KB
  • gallery/src/demos/DemoSpotlight.tsx 1 KB
  • gallery/src/demos/DemoTextureCard.tsx 1 KB
  • gallery/src/demos/index.ts 2 KB
  • gallery/src/gallery/search.ts 2 KB
  • gallery/src/gallery/state.ts 5 KB
  • gallery/src/gallery/ui.tsx 3 KB
  • gallery/src/lib/utils.ts 1 KB
  • references/adaptation.md 4 KB
  • references/conventions.md 2 KB
  • references/dependencies.md 2 KB
  • references/handoff.md 2 KB
  • references/health-report-schema.md 3 KB
  • references/live-fetch.md 9 KB
  • scripts/_registry.py 1 KB
  • scripts/build-agent-dirs.sh 5 KB
  • scripts/health-check.py 20 KB
  • scripts/pin-registry.py 6 KB
  • scripts/registry_pin.py 3 KB
  • scripts/smoke-test.mjs 39 KB
  • scripts/test_validate.py 8 KB
  • scripts/validate.py 17 KB

Versions

RepositoryScoreLicence
This page · Qadri-uk/claude-skills95Apache-2.0
sukirman1901/frontend-expert100MIT
udecode/plate91MIT

Database snapshot: 13.11.2026 · package version 3ee76f7354cd (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100magicui
    Adds animated React components (marquee, number ticker, shimmer button, confetti, globe, animated beam) to landing pages with Magic UI, a copy-the-source library built on Tailwind CSS and shadcn/ui. Use when asked to add animated UI components, build an impressive landing page…
  • 100aceternity-ui
    Aceternity UI is a collection of animated React components (3D cards, spotlight, background beams, moving borders, wavy backgrounds) built with Tailwind CSS and the motion library, installed into your project as source through the shadcn CLI. Use when someone asks for "animated…
  • 100magic-ui
    Add, customise or troubleshoot Magic UI's animated React components — marquee, globe, blur-fade, shiny-button, magic-card and the rest of the @magicui registry — in a Tailwind + shadcn project. Use for animated hero sections, testimonial walls, CTA bands and feature grids, or to…
  • 100aceternity-ui
    Trending animated React, Tailwind CSS, and Framer Motion components by Manu Arora (ui.aceternity.com). Use when building modern hero sections, 3D cards, lamp effects, canvas reveals, background beams, tracing beams, sparkles, and interactive visual showcases. Enforces adaptation…
  • 95animated-component-libraries
    Pre-built animated React component collections combining Magic UI (150+ TypeScript/Tailwind/Motion components) and React Bits (90+ minimal-dependency animated components). Use this skill when building landing pages, marketing sites, dashboards, or interactive UIs requiring…
  • 100component-patterns
    Patterns from modern component libraries — animated text, wrapper effects, ambient backgrounds, and composed UI, with the accessibility and performance rules they usually omit. Use when pulling a pattern from a third-party library — animated text, magnetic/tilt/spotlight…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.