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
npx skills add laguagu/claude-code-nextjs-skills --skill ai-app -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/ai-app/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ai-app/
1Skills CLI (Vercel)
npx skills add laguagu/claude-code-nextjs-skills --skill ai-app -a codex2Manually: put the files in place
.agents/skills/ai-app/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add laguagu/claude-code-nextjs-skills --skill ai-app -a cursor2Manually: put the files in place
.cursor/skills/ai-app/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install laguagu/claude-code-nextjs-skills skills/ai-app2Manually: put the files in place
.github/skills/ai-app/SKILL.md1Skills CLI (Vercel)
npx skills add laguagu/claude-code-nextjs-skills --skill ai-app -a gemini-cli2Platform CLI
gemini skills install https://github.com/laguagu/claude-code-nextjs-skills --path skills/ai-appManually: put the files in place
.devin/skills/ai-app/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add laguagu/claude-code-nextjs-skills --skill ai-app -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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