What is the Aceternity UI skill?
Aceternity UI is a skill in the secondsky skills collection for animated React components in Next.js with Tailwind. It covers shadcn CLI setup, the @aceternity registry entry, fifteen component categories such as backgrounds, 3D cards and scroll effects, usage examples and fixes for common setup errors.
The skill describes Aceternity UI as a premium React component library for Next.js, with 100+ animated and interactive components built on Tailwind CSS and Framer Motion. Components are copied into your codebase, not pulled in as an npm package.
Its job is to stop an agent from fumbling the setup. It carries the install order, the components.json registry entry, a categorized component list and a troubleshooting section.
What changes in your agent's output
- Components arrive through the shadcn CLI with the @aceternity namespace, landing in components/ui.
- Animated files start with the use client directive, which the skill flags as required.
- The cn helper and the motion, clsx and tailwind-merge dependencies are added when missing.
- Hero sections pick from named effects such as Background Beams, Spotlight or Hero Parallax.
- Heavy backgrounds can be lazy loaded with a dynamic import and SSR turned off.
Who the Aceternity UI skill is for
Best for
- Next.js 13 and later projects that already use Tailwind.
- Landing pages, portfolios and agency sites that need animated heroes and cards.
- Developers who want to own and edit component source.
- Anyone hitting module not found, missing cn or non-animating components.
Not for
- Vue or Nuxt apps. A Vue-focused skill such as Nuxt UI covers that stack instead.
- Teams that need a plain, motion-light interface.
- Projects that cannot accept the license terms of the component library, which the skill says are separate from the skill itself.
Use it with UiChemy
Aceternity components are React code for Next.js, not WordPress content. For WordPress, UiChemy Composer writes HTML, CSS and JS inside Elementor or Gutenberg. Click Get Started on uichemy.com.
How to install Aceternity UI Skill: Animated React Components for Next.js
git clone https://github.com/secondsky/claude-skillsTwo reference files ship with it: a quick start and a component catalog.Clone the collection
Run the clone command. The repo holds many plugins, each with its own skills folder.
Copy the skill
Copy plugins/aceternity-ui/skills/aceternity-ui into the skills folder your agent reads. Keep the references folder beside SKILL.md.
Reload the agent
Restart or reload your agent so the skill is indexed.
Initialize shadcn in your app
In a Next.js project, run the shadcn init command, then add the @aceternity registry to components.json as the skill shows.
Add one component
Run shadcn add @aceternity/background-beams and render it behind a hero section.
Check that it loaded
Ask your agent to build a hero with Background Beams. It should add the registry entry, install the component and mark the file as a client component.
Key features
- PrerequisitesNext.js 13 or later with App Router recommended, React 16.8 or later, Tailwind CSS v4 or v3, TypeScript recommended and Node.js 20 or later.
- shadcn CLI setupInitialize with shadcn init, pick the New York style and CSS variables, then add the registry entry to components.json.
- Namespaced registryComponents install with a command such as shadcn add @aceternity/background-beams, which writes the file to components/ui.
- Manual fallbackIf the registry fails, install motion, clsx and tailwind-merge, add the cn helper to lib/utils.ts and copy the code from the library site.
- Fifteen categoriesBackgrounds (28), cards (15), text (10), scroll and parallax (5), navigation (5), buttons (4), carousels (4) and more through loaders and sections.
- Usage examplesShort TSX snippets for Background Beams, the 3D card, sticky scroll reveal, typewriter text, moving border, vanish input and animated modal.
- Performance notesMark animated files as client components and lazy load heavy backgrounds with next/dynamic and ssr false.
- Dark modeShows the dark: class pattern, plus the Tailwind v4 custom variant line and the v3 darkMode class setting.
- TroubleshootingFive common failures with fixes: missing motion, undefined cn, no animation, Tailwind classes ignored and dark mode not applying.
- Secure installationAdvises blocking post-install scripts, waiting a cooldown period for new versions and auditing packages before running the setup commands.
Frequently asked questions
What is the Aceternity UI skill?
It is a SKILL.md in the secondsky skills collection that guides an AI coding agent through installing and using Aceternity UI, a library of 100+ animated React components for Next.js built on Tailwind CSS and Framer Motion, with setup steps and troubleshooting.
How do I install Aceternity UI with this skill?
Copy the skill folder into your agent's skills folder, then in your Next.js app run the shadcn init command, add the @aceternity registry URL to components.json, and add components with shadcn add @aceternity followed by the component name.
Is Aceternity UI an npm package?
The skill says no. It describes the library as copy-paste friendly, with components installed through the shadcn CLI into your own components folder so you can edit the source. Dependencies such as motion, clsx and tailwind-merge are installed separately.
Does the Aceternity UI skill work with Tailwind v4?
Yes. The skill lists Tailwind CSS v4 with CSS-first configuration as the target and says v3 also works with a JS config. It shows the single import line for v4 and the custom variant for class-based dark mode.
What license applies?
The skill folder is MIT licensed according to its frontmatter. The skill adds that Aceternity UI components carry their own licensing, so check the library site before shipping them in a commercial project.
Does it work with Cursor or Codex?
The repo is described as skills for Claude Code and the SKILL.md has no setup notes for other agents. It is plain markdown, so check how your own agent loads skills before relying on it.
What are Aceternity UI alternatives?
For another animated React library, see Magic UI or the broader Animated Component Libraries skill, which compares Magic UI and React Bits. For motion rules in React, Framer Motion adds performance guidance for animation code.
Can I use Aceternity components in WordPress?
Not directly, because they are React and Next.js code. UiChemy Composer writes HTML, CSS and JS inside Elementor or Gutenberg for WordPress pages, so you can still get animated sections there. Click Get Started on uichemy.com.


