Agent Skills

Nuxt MCP Toolkit includes agent skills that help AI assistants build, review, and troubleshoot MCP servers in your Nuxt application.

What are Agent Skills?

Agent Skills is an open specification for packaging AI assistant capabilities. Skills provide:

• Domain knowledge: Best practices for MCP tools, resources, and prompts
• Guided development: Step-by-step help creating and configuring MCP servers
• Code review: Identify anti-patterns and suggest improvements
• Troubleshooting: Diagnose common issues with auto-imports, endpoints, and validation

Available Skills

Installing the Skill

Compatible agents (Cursor, Claude Code, etc.) can discover and use skills automatically.

To manually install with the skills CLI:

npx skills add nuxt-modules/mcp-toolkit

What the Skill Does

Setup & Configure

The skill guides you through:

• Installing @nuxtjs/mcp-toolkit in your Nuxt app
• Configuring nuxt.config.ts with MCP options
• Creating the server/mcp/ directory structure
• Verifying the MCP endpoint is accessible

Create Definitions

The skill helps you build:

• Tools: Functions AI assistants can call, with Zod validation and error handling
• Resources: Read-only data exposed via URIs (static or dynamic with templates)
• Prompts: Reusable message templates with dynamic arguments
• Middleware: Authentication, rate limiting, logging, and CORS handlers

Review & Audit

The skill analyzes your codebase for:

• Missing descriptions: Tools or resources without clear descriptions
• Weak validation: Missing .describe() on Zod fields
• Error handling gaps: Missing isError: true on error responses
• Security issues: Exposed sensitive data in resources or tools
• Performance: Missing caching on expensive operations

Troubleshoot

The skill diagnoses:

• Auto-imports not working: Module configuration and file placement issues
• Endpoint not accessible: Server configuration and routing problems
• Validation errors: Schema mismatches and type issues
• Tool not discovered: File naming, exports, and directory structure problems

Test with Evals

The skill helps you:

• Set up Evalite for MCP tool selection testing
• Write eval scenarios to validate tool selection
• Configure CI/CD integration for automated testing

Example Prompts

Ask your AI assistant:

Setup an MCP server in my Nuxt app

Create a tool to fetch user data from my database

Review my MCP implementation for best practices

My auto-imports aren't working, help me troubleshoot

Create eval tests for my MCP tools

Skill Structure

skills/
└── manage-mcp/
    ├── SKILL.md              # Main skill instructions
    └── references/
        ├── middleware.md     # Middleware patterns & examples
        ├── tools.md          # Tool examples
        ├── resources.md      # Resource examples
        ├── prompts.md        # Prompt examples
        ├── testing.md        # Testing guide with Evalite
        └── troubleshooting.md # Troubleshooting guide

Reference Documents

The skill includes reference documents that provide:

middleware.md

• Authentication patterns (API keys, JWT)
• Rate limiting and CORS configuration
• Logging and request tracking
• Security best practices

tools.md

• Tool definition patterns with various input types
• Error handling and caching examples
• Real-world tool implementations

resources.md

• Static and dynamic resource patterns
• File, API, and database resource examples
• URI template usage

prompts.md

• Static and dynamic prompt patterns
• Multi-message conversation templates
• Code review and documentation generator examples

testing.md

• Evalite setup and configuration
• Test scenario patterns
• CI/CD integration

troubleshooting.md

• Auto-import resolution steps
• Endpoint debugging guide
• Validation error fixes
• Performance optimization tips

Next Steps

• Installation - Get started with Nuxt MCP Toolkit
• Tools - Learn how to create MCP tools
• Resources - Expose data via MCP resources
• Prompts - Create reusable prompt templates