Skip to content

laguagu/claude-code-nextjs-skills / skills/ai-elements

ai-elements

Verified

Maintains AI chat UI built from elements.ai-sdk.dev AI Elements components already copied into the project. Use when changing or debugging those components (conversations, messages, prompt inputs, attachments, reasoning, tool output, sources). New chat UI uses the shadcn/ui AI Elements patterns (`shadcn` skill).

FileKindSize
SKILL.mdskill md3.4 KB
references/agent.mdmarkdown4.1 KB
references/artifact.mdmarkdown2.9 KB
references/attachments.mdmarkdown5.6 KB
references/audio-player.mdmarkdown5.2 KB
references/canvas.mdmarkdown1.1 KB
references/chain-of-thought.mdmarkdown3.3 KB
references/checkpoint.mdmarkdown5.6 KB
references/code-block.mdmarkdown5.4 KB
references/commit.mdmarkdown5.8 KB
references/confirmation.mdmarkdown8.7 KB
references/connection.mdmarkdown1.1 KB
references/context.mdmarkdown5.8 KB
references/controls.mdmarkdown971 B
references/conversation.mdmarkdown7.4 KB
references/edge.mdmarkdown2.1 KB
references/environment-variables.mdmarkdown3.7 KB
references/file-tree.mdmarkdown2.0 KB
references/image.mdmarkdown4.1 KB
references/inline-citation.mdmarkdown10.9 KB
references/integration.mdmarkdown4.3 KB
references/jsx-preview.mdmarkdown3.2 KB
references/message.mdmarkdown9.7 KB
references/mic-selector.mdmarkdown7.7 KB
references/model-selector.mdmarkdown4.3 KB
references/node.mdmarkdown2.8 KB
references/open-in-chat.mdmarkdown2.7 KB
references/package-info.mdmarkdown3.2 KB
references/panel.mdmarkdown1.0 KB
references/persona.mdmarkdown5.4 KB
references/plan.mdmarkdown3.2 KB
references/prompt-input.mdmarkdown20.0 KB
references/queue.mdmarkdown5.4 KB
references/reasoning.mdmarkdown7.8 KB
references/sandbox.mdmarkdown4.3 KB
references/schema-display.mdmarkdown2.5 KB
references/shimmer.mdmarkdown1.6 KB
references/snippet.mdmarkdown2.2 KB
references/sources.mdmarkdown5.9 KB
references/speech-input.mdmarkdown6.5 KB
references/stack-trace.mdmarkdown5.6 KB
references/suggestion.mdmarkdown4.6 KB
references/task.mdmarkdown6.8 KB
references/terminal.mdmarkdown3.1 KB
references/test-results.mdmarkdown5.0 KB
references/tool.mdmarkdown8.5 KB
references/toolbar.mdmarkdown983 B
references/transcription.mdmarkdown4.9 KB
references/voice-selector.mdmarkdown10.3 KB
references/web-preview.mdmarkdown6.3 KB
scripts/agent.tsxother1.6 KB
scripts/artifact.tsxother2.9 KB
scripts/attachments-inline.tsxother3.5 KB
scripts/attachments-list.tsxother2.2 KB
scripts/attachments.tsxother2.0 KB
scripts/audio-player-remote.tsxother1.0 KB
scripts/audio-player.tsxother1.8 KB
scripts/chain-of-thought.tsxother138.6 KB
scripts/checkpoint.tsxother2.8 KB
scripts/code-block-dark.tsxother1.0 KB
scripts/code-block.tsxother2.9 KB
scripts/commit.tsxother2.1 KB
scripts/confirmation-accepted.tsxother1.2 KB
scripts/confirmation-rejected.tsxother1.1 KB
scripts/confirmation-request.tsxother1.7 KB
scripts/confirmation.tsxother1.7 KB
scripts/context.tsxother1.0 KB
scripts/conversation.tsxother4.1 KB
scripts/environment-variables.tsxother1.7 KB
scripts/file-tree-basic.tsxother380 B
scripts/file-tree-expanded.tsxother609 B
scripts/file-tree-selection.tsxother619 B
scripts/file-tree.tsxother1.5 KB
scripts/image.tsxother136.5 KB
scripts/inline-citation.tsxother3.2 KB
scripts/jsx-preview.tsxother3.2 KB
scripts/message.tsxother10.1 KB
scripts/mic-selector.tsxother1.2 KB
scripts/model-selector.tsxother8.3 KB
scripts/open-in-chat.tsxother704 B
scripts/package-info.tsxother1.3 KB
scripts/persona-command.tsxother2.5 KB
scripts/persona-glint.tsxother2.5 KB
scripts/persona-halo.tsxother2.5 KB
scripts/persona-mana.tsxother2.5 KB
scripts/persona-obsidian.tsxother2.5 KB
scripts/persona-opal.tsxother2.5 KB
scripts/plan.tsxother1.9 KB
scripts/prompt-input-cursor.tsxother15.1 KB
scripts/prompt-input-tooltip.tsxother1.1 KB
scripts/prompt-input.tsxother7.4 KB
scripts/queue-prompt-input.tsxother10.5 KB
scripts/queue.tsxother8.0 KB
scripts/reasoning.tsxother2.2 KB
scripts/sandbox.tsxother5.4 KB
scripts/schema-display-basic.tsxother221 B
scripts/schema-display-body.tsxother487 B
scripts/schema-display-nested.tsxother470 B
scripts/schema-display-params.tsxother374 B
scripts/schema-display.tsxother2.7 KB
scripts/shimmer-duration.tsxother934 B
scripts/shimmer-elements.tsxother1.1 KB
scripts/shimmer.tsxother443 B
scripts/snippet-plain.tsxother362 B
scripts/snippet.tsxother589 B
scripts/sources-custom.tsxother1.0 KB
scripts/sources.tsxother752 B
scripts/speech-input.tsxother2.3 KB
scripts/stack-trace-collapsed.tsxother1.1 KB
scripts/stack-trace-no-internal.tsxother1.2 KB
scripts/stack-trace.tsxother1.9 KB
scripts/suggestion-input.tsxother4.5 KB
scripts/suggestion.tsxother802 B
scripts/task.tsxother1.5 KB
scripts/terminal-basic.tsxother169 B
scripts/terminal-clear.tsxother523 B
scripts/terminal-streaming.tsxother1007 B
scripts/terminal.tsxother2.3 KB
scripts/test-results-basic.tsxother464 B
scripts/test-results-errors.tsxother1.3 KB
scripts/test-results-suites.tsxother901 B
scripts/test-results.tsxother2.7 KB
scripts/tool-input-available.tsxother738 B
scripts/tool-input-streaming.tsxother683 B
scripts/tool-output-available.tsxother1.7 KB
scripts/tool-output-error.tsxother1.1 KB
scripts/tool.tsxother6.7 KB
scripts/transcription.tsxother4.9 KB
scripts/voice-selector.tsxother7.1 KB
scripts/web-preview.tsxother2.8 KB
---
name: ai-elements
description: Maintains AI chat UI built from elements.ai-sdk.dev AI Elements components already copied into the project. Use when changing or debugging those components (conversations, messages, prompt inputs, attachments, reasoning, tool output, sources). New chat UI uses the shadcn/ui AI Elements patterns (`shadcn` skill).
---

# AI Elements

Use AI Elements where its components fit the interaction. The generated source
belongs to the project: inspect it for the actual API and customize it deliberately.

vercel/ai-elements will be deprecated at the end of November 2026 (announced
2026-10-14, CLI 1.9.1). Its replacement is AI Elements from shadcn/ui
(https://ui.shadcn.com/docs/ai-elements): copy-in patterns built on Message,
Bubble, Message Scroller, Trace and Code Block. Copied files in
`components/ai-elements/` keep working. To move one onto shadcn/ui, use the
'Migrating from AI SDK Elements' prompt on its pattern page; some elements
(artifact, canvas, persona, web-preview, ...) have no replacement. For new chat
UI use the `shadcn` skill, not `ai-elements add`.

## Project and documentation

Follow the project's package manager, aliases, shadcn configuration and AI SDK
major. Read `ai-sdk` to resolve the installed version, then the appropriate
`ai-sdk-6` or `ai-sdk-7` guidance. AI Elements and AI SDK versions can change
independently.

Read generated `components/ai-elements/<component>.tsx` first, then the
matching `references/` file and its `scripts/` examples. Use the
[AI Elements site](https://elements.ai-sdk.dev) for current documentation. Load only relevant references; verify bundled
examples against installed source.

To add a missing component to an existing install, use the project's runner
with `ai-elements@latest add <component>` or
`shadcn@latest add @ai-elements/<component>`. Components land in
`components/ai-elements/` under the alias configured in `components.json`; that
installed source is the offline API reference. Check installed components and
review generated files before replacing local customization. Use `shadcn` for
registry, preset and primitive-base details.

AI Elements targets the Radix base (upstream uses style `new-york` with
`radix-ui`). On Base UI projects expect prop mismatches in prompt-input,
attachments, inline-citation and plan ([upstream #446](https://github.com/vercel/ai-elements/issues/446),
open 2026-10-11); adapt the installed copies.

## Integration

[Integration](references/integration.md) covers the UI/SDK boundary, v6
pitfalls and the `context.tsx` patch that AI SDK 7 needs. Keep stable message
IDs and render supported message parts with the generated compound components.
Keep model choice, tools, credentials and authorization on the server.

Compose the states the feature needs: streaming, completion, retry, cancellation,
attachments, approval or sources. Avoid adding components merely because the
library offers them. Preserve keyboard interaction, accessible labels and useful
scroll behavior.

When rendering fails, inspect the owned component, theme imports, semantic tokens
and actual configured aliases. Do not copy a default `tsconfig` or replace the
project's theme to fix one import.
For unstyled markdown, check the [MessageResponse setup](references/message.md#markdown-styling).

Verify the rendered flow with real message states and the project's checks;
type correctness alone does not establish usable streaming or attachment behavior.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall