---
title: "Agent Skills"
description: "AI-assisted MCP server development using Agent Skills. Let AI help you setup, create, review, and troubleshoot MCP servers in your Nuxt app."
canonical_url: "https://mcp-toolkit.nuxt.dev/getting-started/agent-skills"
---
# Agent Skills

> AI-assisted MCP server development using Agent Skills. Let AI help you setup, create, review, and troubleshoot MCP servers in your Nuxt app.

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

This documentation site is built with [Docus](https://docus.dev), which publishes skills under [`/.well-known/skills/`](https://mcp-toolkit.nuxt.dev/.well-known/skills/index.json) following the [Agent Skills discovery](https://docus.dev/en/ai/skills) convention. That lets the [`skills` CLI](https://agentskills.io) install them from the production URL below.

## What are Agent Skills?

[Agent Skills](https://agentskills.io/) 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

<table>
<thead>
  <tr>
    <th>
      Skill
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        skills/manage-mcp
      </code>
    </td>
    
    <td>
      Setup, create, review, troubleshoot, and test MCP servers in Nuxt
    </td>
  </tr>
</tbody>
</table>

## Installing the Skill

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

Install from this site’s production URL (recommended):

```bash [Terminal]
npx skills add https://mcp-toolkit.nuxt.dev
```

The CLI fetches the catalog from [`/.well-known/skills/index.json`](https://mcp-toolkit.nuxt.dev/.well-known/skills/index.json) and installs the `manage-mcp` skill and its reference files. For pull request previews, use the same command with your preview deployment URL ([Docus: preview and versioning](https://docus.dev/en/ai/skills)).

## 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:

<prompt :actions="["copy","cursor","windsurf"]" description="Example — set up an MCP server" icon="i-lucide-sparkles">

Setup an MCP server in my Nuxt app

</prompt>

<prompt :actions="["copy","cursor","windsurf"]" description="Example — database tool" icon="i-lucide-sparkles">

Create a tool to fetch user data from my database

</prompt>

<prompt :actions="["copy","cursor","windsurf"]" description="Example — review MCP code" icon="i-lucide-sparkles">

Review my MCP implementation for best practices

</prompt>

<prompt :actions="["copy","cursor","windsurf"]" description="Example — troubleshoot auto-imports" icon="i-lucide-sparkles">

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

</prompt>

<prompt :actions="["copy","cursor","windsurf"]" description="Example — MCP eval tests" icon="i-lucide-sparkles">

Create eval tests for my MCP tools

</prompt>

## Skill Structure

In the [mcp-toolkit repository](https://github.com/nuxt-modules/mcp-toolkit), skill sources live under the docs app:

```text
apps/docs/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
```

Deployed files are served as `/.well-known/skills/manage-mcp/...` on [mcp-toolkit.nuxt.dev](https://mcp-toolkit.nuxt.dev).

## 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](https://mcp-toolkit.nuxt.dev/getting-started/installation) - Get started with Nuxt MCP Toolkit
- [Tools](https://mcp-toolkit.nuxt.dev/tools/overview) - Learn how to create MCP tools
- [Resources](https://mcp-toolkit.nuxt.dev/resources/overview) - Expose data via MCP resources
- [Prompts](https://mcp-toolkit.nuxt.dev/prompts/overview) - Create reusable prompt templates
- [Apps](https://mcp-toolkit.nuxt.dev/apps/overview) - Ship interactive UI widgets to AI hosts

---

- [Agent Skills Spec](https://agentskills.io)
- [Skills catalog (JSON)](https://mcp-toolkit.nuxt.dev/.well-known/skills/index.json)


## Sitemap

See the full [sitemap](https://mcp-toolkit.nuxt.dev/sitemap.md) for all pages.