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

references/context.md

View on GitHub
# Context

A compound component system for displaying AI model context window usage, token consumption, and cost estimation.

The `Context` component provides a comprehensive view of AI model usage through a compound component system. It displays context window utilization, token consumption breakdown (input, output, reasoning, cache), and cost estimation in an interactive hover card interface.

See `scripts/context.tsx` for this example.

## Installation

```bash
npx ai-elements@latest add context
```

## Features

- **Compound Component Architecture**: Flexible composition of context display elements
- **Visual Progress Indicator**: Circular SVG progress ring showing context usage percentage
- **Token Breakdown**: Detailed view of input, output, reasoning, and cached tokens
- **Cost Estimation**: Real-time cost calculation using the `tokenlens` library
- **Intelligent Formatting**: Automatic token count formatting (K, M, B suffixes)
- **Interactive Hover Card**: Detailed information revealed on hover
- **Context Provider Pattern**: Clean data flow through React Context API
- **TypeScript Support**: Full type definitions for all components
- **Accessible Design**: Proper ARIA labels and semantic HTML
- **Theme Integration**: Uses currentColor for automatic theme adaptation

## Props

### `<Context />`

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `maxTokens` | `number` | - | The total context window size in tokens. |
| `usedTokens` | `number` | - | The number of tokens currently used. |
| `usage` | `LanguageModelUsage` | - | Detailed token usage breakdown from the AI SDK (input, output, reasoning, cached tokens). |
| `modelId` | `ModelId` | - | Model identifier for cost calculation (e.g.,  |
| `...props` | `ComponentProps<HoverCard>` | - | Any other props are spread to the HoverCard component. |

### `<ContextTrigger />`

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `children` | `React.ReactNode` | - | Custom trigger element. If not provided, renders a default button with percentage and icon. |
| `...props` | `ComponentProps<Button>` | - | Props spread to the default button element. |

### `<ContextContent />`

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `className` | `string` | - | Additional CSS classes for the hover card content. |
| `...props` | `ComponentProps<HoverCardContent>` | - | Props spread to the HoverCardContent component. |

### `<ContextContentHeader />`

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `children` | `React.ReactNode` | - | Custom header content. If not provided, renders percentage and token count with progress bar. |
| `...props` | `ComponentProps<div>` | - | Props spread to the header div element. |

### `<ContextContentBody />`

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `children` | `React.ReactNode` | - | Body content, typically containing usage breakdown components. |
| `...props` | `ComponentProps<div>` | - | Props spread to the body div element. |

### `<ContextContentFooter />`

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `children` | `React.ReactNode` | - | Custom footer content. If not provided, renders total cost when modelId is provided. |
| `...props` | `ComponentProps<div>` | - | Props spread to the footer div element. |

### Usage Components

All usage components (`ContextInputUsage`, `ContextOutputUsage`, `ContextReasoningUsage`, `ContextCacheUsage`) share the same props:

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `children` | `React.ReactNode` | - | Custom content. If not provided, renders token count and cost for the respective usage type. |
| `className` | `string` | - | Additional CSS classes. |
| `...props` | `ComponentProps<div>` | - | Props spread to the div element. |

## Component Architecture

The Context component uses a compound component pattern with React Context for data sharing:

1. **`<Context>`** - Root provider component that holds all context data
2. **`<ContextTrigger>`** - Interactive trigger element (default: button with percentage)
3. **`<ContextContent>`** - Hover card content container
4. **`<ContextContentHeader>`** - Header section with progress visualization
5. **`<ContextContentBody>`** - Body section for usage breakdowns
6. **`<ContextContentFooter>`** - Footer section for total cost
7. **Usage Components** - Individual token usage displays (Input, Output, Reasoning, Cache)

## Token Formatting

The component uses `Intl.NumberFormat` with compact notation for automatic formatting:

- Under 1,000: Shows exact count (e.g., "842")
- 1,000+: Shows with K suffix (e.g., "32K")
- 1,000,000+: Shows with M suffix (e.g., "1.5M")
- 1,000,000,000+: Shows with B suffix (e.g., "2.1B")

## Cost Calculation

When a `modelId` is provided, the component automatically calculates costs using the `tokenlens` library:

With tokenlens 1.3.1, Context defaults to its bundled catalog; unavailable pricing renders `$0.00`, which does not prove zero cost. Supply custom cost/usage children or omit those components.

- **Input tokens**: Cost based on model's input pricing
- **Output tokens**: Cost based on model's output pricing
- **Reasoning tokens**: Special pricing for reasoning-capable models
- **Cached tokens**: Reduced pricing for cached input tokens
- **Total cost**: Sum of all token type costs

Costs are formatted using `Intl.NumberFormat` with USD currency.

## Styling

The component uses Tailwind CSS classes and follows your design system:

- Progress indicator uses `currentColor` for theme adaptation
- Hover card has customizable width and padding
- Footer has a secondary background for visual separation
- All text sizes use the `text-xs` class for consistency
- Muted foreground colors for secondary information
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