Skip to main content
skill CX Codex

ai-app — Claude Code skill: what it does, how to install

A skill for Claude Code sets up full-stack Next.js AI applications with AI SDK and shadcn/ui. Activates when generating chatbots, agent dashboards, and custom AI tools.

MIT 198 installs ★ 74 updated 2026-11-14

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add laguagu/claude-code-nextjs-skills --skill ai-app -a claude-code
Open on GitHub

What ai-app does

The skill structures full-stack Next.js apps around user data, streams, and operational flows. It defaults to AI SDK 7 (ai@7, @ai-sdk/react@4) alongside recent provider packages, and selects Bun for new JavaScript projects.

Chat interfaces rely on shadcn/ui AI Elements patterns such as Message, Bubble, Message Scroller, and Trace. The legacy ai-elements package targets v6 and breaks typechecks on v7 without a patch, so the skill avoids it for fresh components.

All provider keys and authorization logic remain on the server. AI SDK 7 requires Node.js 22+, and the setup explicitly flags outdated Next.js releases with known security advisories.

What it helps with

  • scaffold a full-stack Next.js chatbot with stream handling
  • configure agent dashboards with execution and approval states
  • assemble chat interfaces using shadcn/ui AI Elements
  • wire AI SDK 7 providers with server-side credential isolation

Example prompts for the agent

  • Build a streaming Next.js chatbot using AI SDK 7 and shadcn/ui
  • Set up an agent dashboard with approval states and run history
  • Add a chat interface with Message and Bubble components wired to a server action

How to install ai-app

1Skills CLI (Vercel)

npx skills add laguagu/claude-code-nextjs-skills --skill ai-app -a claude-code

2Manually: put the files in place

~/.claude/skills/ai-app/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ai-app/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ai-app

How to install ai-app in Claude Code?

Run npx skills add laguagu/claude-code-nextjs-skills --skill ai-app -a claude-code. You can also manually place the skill file into ~/.claude/skills/ai-app/SKILL.md.

What does the ai-app skill do?

It guides the agent through creating full-stack Next.js AI apps using the AI SDK and official shadcn/ui UI patterns.

What are the requirements for running ai-app with AI SDK 7?

You need Node.js 22+ or Bun, plus model provider API credentials configured strictly in server-side environment variables.

Source text

SKILL.md · MIT
---
name: ai-app
description: >-
  Builds full-stack Next.js AI applications with the AI SDK and the shadcn/ui
  AI Elements patterns.
  Use when creating a chatbot, agent dashboard or custom AI application.
---

# AI application setup

Build the requested app around its users, data and operations. Keep the existing
stack and SDK major unless migration is part of the task; use Bun for new
JavaScript projects.

1. Resolve the installed AI SDK major through `ai-sdk`; use `ai-sdk-6` or
   `ai-sdk-7` for implementation. For a new app, default to **AI SDK 7**: `ai@7`,
   `@ai-sdk/react@4` and each provider package at `latest` (provider majors
   differ; Node.js 22+). Keep v6 only when a required dependency pins it. Build
   new chat UI from the AI Elements patterns in shadcn/ui
   (https://ui.shadcn.com/docs/ai-elements); they need no v7 patch. The older
   elements.ai-sdk.dev library (`ai-elements`) will be deprecated at the end of
   November 2026, targets v6, and its `context.tsx` fails a v7 typecheck until
   patched. Read version-matched `ai/docs/` and provider docs before using web
   examples.
2. Use `nextjs-shadcn` for framework setup and `frontend-design` for visual
   direction. Compose chat UI from the shadcn/ui patterns (Message, Bubble,
   Message Scroller, Trace; the `shadcn` skill). For a chatbot,
   shadcn-ui/chatbot-template is a starting point after upgrading its Next.js
   (16.3.6) to a release without open security advisories (16.4.5+ on
   2026-11-09). Use `ai-elements` only for components already copied
   from elements.ai-sdk.dev. Inspect installed source instead of assuming
   registry props.
3. Keep provider credentials and authorization on the server. Resolve model IDs
   from configuration or the selected provider's catalog.
4. Implement the smallest complete user flow. Add persistence, approvals,
   attachments, search, suggestions or dashboards when the app needs them.
5. Match the server stream to the client transport. Verify a second turn,
   relevant tool states, safe failures and mobile behavior, alongside the
   project's typecheck/build.

## Read for the app being built

- [Chatbot](references/chatbot.md): conversation and stream contracts.
- [Agent dashboard](references/agent-dashboard.md): execution, approval and run state.
- [Examples](references/examples.md): current official implementations.
- [Project structure](references/project-structure.md): boundaries without a fixed tree.

These references describe requirements, not copyable production templates.

© laguagu · MIT · laguagu/claude-code-nextjs-skills

Similar skills

All skills for AI and ML →

From the same set13

The whole set →
next-best-practices The next-best-practices Claude Code skill applies Next.js App Router practices while writing or reviewing code. It covers hydration bugs, RSC boundaries, async APIs, and data handling. CX Codex +1 286installs postgres-semantic-search The postgres-semantic-search Claude Code skill builds and tunes PostgreSQL retrieval. It covers semantic and hybrid search, evaluation, and troubleshooting weak results. CX Codex +1 227installs cache-components A skill for mastering Next.js Cache Components and Partial Prerendering in version 16.4+. Advises on the use cache directive, setting cache lifetime with cacheLife(), tagging data with cacheTag(), and invalidating via updateTag(). CX Codex +1 222installs ai-sdk-6 ai-sdk-6 — a skill for projects already on Vercel AI SDK v6. Covers building agents, chatbots, tool integrations, streaming responses and structured output with patterns specific to the v6 API. CX Codex +1 218installs nextjs-chatbot nextjs-chatbot guides a production web chat in Next.js: tool approval, saved conversations, rendered tool results, follow-up suggestions and an embeddable widget. CX Codex +1 161installs ai-sdk Identifies the installed Vercel AI SDK major version and routes to matching API docs. Activates when working with generateText, streamText, useChat, or tools. CX Codex +1 149installs hetzner-cloud This Claude Code skill manages Hetzner Cloud resources through the hcloud CLI. It activates for Hetzner requests, location codes, or VPS work in a project already hosted there. CX Codex +1 125installs go go — a Claude Code skill that launches the web app and verifies UI changes in a real browser. Smoke tests functional behavior, console errors, and HTTP failures. CX Codex +1 112installs

Project sponsors

Companies that keep this analytics open