Skip to content

laguagu/claude-code-nextjs-skills

v1.0.15MIT

Agent skills for building Next.js + AI SDK applications: app scaffolding, shadcn/ui, RSC and caching, pgvector search, SEO, and browser verification.

🧠 Claude Code AI Skills

24 skills and 2 agents for building AI applications with Next.js, Bun and modern UI tools.

⚑ Quick Start

Install in Claude Code:

/plugin marketplace add laguagu/claude-code-nextjs-skills
/plugin install claude-code-nextjs-skills@laguagu

Then use /claude-code-nextjs-skills:ai-app to build an app or /claude-code-nextjs-skills:go to check it in the browser. Relevant skills can also activate from your request.

πŸ“‹ Skills

πŸš€ App Generators

SkillDescription
ai-appFull-stack AI app (chatbots, agents, dashboards)
nextjs-shadcnNext.js + shadcn/ui with deliberate typography, backgrounds, and design-system lint via @shadcn/lint
nextjs-chatbotWeb chatbot patterns (HITL, persistence, streaming)

🎨 UI & Design

SkillDescription
shadcnshadcn/ui component management
iconsSourcing icons, flags, file-type badges and brand logos (Iconify, svgl)
frontend-designProduction-grade frontend interfaces
web-design-guidelinesUI/UX review against Web Interface Guidelines
chrome-devtoolsLive browser inspection via Chrome DevTools MCP (DOM, console, network, performance)
goBrowser smoke test β€” verify recent UI changes work

⚑ Next.js

SkillDescription
next-best-practicesInstalled-version docs for routing, RSC and Next.js integration
react-best-practicesReact/Next.js performance optimization (Vercel)
cache-componentsCache Components, freshness, invalidation and isolation
nextjs-seoSEO (metadata, sitemaps, JSON-LD)
vercel-react-view-transitionsReact View Transitions and navigation motion

πŸ€– AI SDKs

SkillDescription
ai-sdkVercel AI SDK version discovery and documentation
ai-sdk-6AI SDK v6 (agents, streaming, tools)
ai-sdk-7AI SDK v7 (WorkflowAgent, harnesses, v6β†’v7 migration)
ai-elementsAI Elements UI components
openai-agents-sdkOpenAI Agents SDK (Python)

πŸ—„οΈ Database & Search

SkillDescription
postgres-semantic-searchpgvector semantic & hybrid search
supabase-postgres-best-practicesPostgres optimization (Supabase)

πŸ› οΈ Tooling

SkillDescription
skill-creatorCreate, test, and optimize custom skills (extended)
handoffWrite a HANDOFF.md so a fresh agent can continue your work
hetzner-cloudHetzner Cloud infrastructure via the hcloud CLI

πŸ€– Custom Agents

Example agents for common workflows. Installed with the Claude Code plugin; otherwise copy to .claude/agents/.

AgentDescription
code-simplifierRefines code for clarity (DRY/KISS/YAGNI)
e2e-testerE2E testing via DevTools MCP, Playwright, or Claude in Chrome

πŸ“¦ Based On

SkillOriginal SourceLicense
ai-sdkvercel/aiApache 2.0
cache-componentsvercel-labs/next-skills (archived; maintained locally)MIT
react-best-practicesvercel-labs/agent-skills-
skill-creatoranthropics/skills (extended)Apache 2.0
next-best-practicesvercel-labs/next-skills (archived; maintained locally)-
web-design-guidelinesskills.sh/vercel-labs/agent-skills-
supabase-postgres-best-practicessupabase/agent-skillsMIT
chrome-devtoolsaddyosmani/agent-skills-
shadcnshadcn/uiMIT

πŸ“₯ Other Installation Options

  • Individual skills: copy a skill folder and any referenced sibling skills to .claude/skills/ (Claude Code) or .agents/skills/ (Codex). User-wide locations are ~/.claude/skills/ and ~/.agents/skills/.
  • Plugin-capable clients: the root plugin.json uses Agent Plugins format. Check your client's support and loading instructions; the format alone does not guarantee compatibility.
  • Local Claude Code trial: clone this repo and run claude --plugin-dir ./claude-code-nextjs-skills from its parent directory.

πŸ”§ MCP & Project Rules

mcp.json configures Next.js DevTools and the AI Elements registry. Both plugin manifests use this single configuration. Optional Chrome DevTools MCP setup is in the browser testing skill.

AGENTS.md contains an example of Next.js-generated project rules; CLAUDE.md references it. These root files guide work on the repository; installing the plugin does not load them as project context.

examples/global-agents.md is a user-wide instruction file for long autonomous runs: when to keep going, when to stop, and how to report.

πŸ”„ Updating

In Claude Code, run /plugin marketplace update laguagu, then /plugin update claude-code-nextjs-skills@laguagu.

Maintainers: compare upstream updates before merging so local customizations and licenses survive. Validate skills with uvx --from skills-ref agentskills validate <skill-folder> and manifests with claude plugin validate .claude-plugin/plugin.json and claude plugin validate .claude-plugin/marketplace.json.

πŸ“š See Also

agents-best-practices β€” skill auditing, creation and discovery across agent tools.

πŸ“„ License

MIT for original repository content. Bundled skills retain their upstream licenses and attribution; see Based On.