Awesome Agent Skills MCP Server

Un servidor del Protocolo de Contexto de Modelo (MCP) que proporciona acceso a más de 100 habilidades de agentes de IA seleccionadas de la colección VoltAgent Awesome Agent Skills.

GitHub

Prueba este MCPPatrocinado

Documentación

Awesome Agent Skills MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona acceso a más de 100 habilidades de agentes de IA seleccionadas de la colección VoltAgent Awesome Agent Skills.

Transforma tus asistentes de IA en expertos especializados con habilidades de Anthropic, Vercel, Trail of Bits, Hugging Face, Stripe, Expo y muchas otras organizaciones líderes.

🚀 Inicio Rápido

npx awesome-agent-skills-mcp

¡Eso es todo! Añádelo a la configuración de tu cliente MCP y empieza a usar más de 100 habilidades de IA.

Características

Más de 100 Habilidades Seleccionadas - Accede a habilidades de organizaciones líderes como Anthropic, Vercel, Trail of Bits, Hugging Face y más
Sincronización Automática - Obtiene y actualiza habilidades automáticamente desde el repositorio de VoltAgent
Compatible con MCP 2024-11-05 - Compatibilidad total con la última especificación del Model Context Protocol
Soporte Multi-Cliente - Funciona con Claude, GitHub Copilot, OpenCode y cualquier cliente compatible con MCP
Caché Inteligente - Caché eficiente basada en JSON para tiempos de inicio rápidos
Seguridad de Tipos - Construido con TypeScript y Zod para validación en tiempo de ejecución
Cero Configuración - Funciona de inmediato con valores predeterminados sensatos

Inicio Rápido

Usando npx (Recomendado)

npx awesome-agent-skills-mcp

Instalación Global

npm install -g awesome-agent-skills-mcp
awesome-agent-skills-mcp

Instalación

Requisitos Previos

Node.js >= 20.0.0
npm o yarn

Desde npm

npm install awesome-agent-skills-mcp

Desde el Código Fuente

git clone https://github.com/shadowrootdev/awesome-agent-skills-mcp.git
cd awesome-agent-skills-mcp
npm install
npm run build

Configuración

VS Code / GitHub Copilot

Crea o actualiza .vscode/mcp.json en tu proyecto:

{
  "servers": {
    "awesome-agent-skills": {
      "command": "npx",
      "args": ["awesome-agent-skills-mcp"]
    }
  }
}

O con una instalación local:

{
  "servers": {
    "awesome-agent-skills": {
      "command": "node",
      "args": ["/path/to/awesome-agent-skills-mcp/dist/index.js"]
    }
  }
}

Importante: Después de añadir la configuración, cierra VS Code por completo (Cmd+Q / Alt+F4) y vuelve a abrirlo para que los cambios surtan efecto.

Claude Desktop

Añade a la configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "awesome-agent-skills": {
      "command": "npx",
      "args": ["awesome-agent-skills-mcp"]
    }
  }
}

OpenCode

Añade a ~/.config/opencode/opencode.json:

{
  "mcp": {
    "awesome-agent-skills": {
      "type": "local",
      "command": ["npx", "awesome-agent-skills-mcp"],
      "enabled": true
    }
  }
}

Variables de Entorno

Variable	Valor Predeterminado	Descripción
`SKILLS_REPO_URL`	`https://github.com/VoltAgent/awesome-agent-skills.git`	URL del repositorio de habilidades
`SKILLS_CACHE_DIR`	`.cache`	Ruta del directorio de caché
`SKILLS_SYNC_INTERVAL`	`60`	Intervalo de sincronización automática en minutos (0 para desactivar)
`LOG_LEVEL`	`info`	Nivel de registro (debug, info, warn, error)

Habilidades Disponibles

El servidor proporciona acceso a más de 100 habilidades de organizaciones líderes:

Anthropic

Procesamiento de documentos, creación de presentaciones, manipulación de hojas de cálculo, manejo de PDF, arte algorítmico, creación de MCP y más.

Habilidad	Descripción
`docx`	Crear, editar y analizar documentos de Word
`pptx`	Creación y edición de presentaciones de PowerPoint
`xlsx`	Manipulación de hojas de cálculo con fórmulas
`pdf`	Procesamiento de PDF y relleno de formularios
`mcp-builder`	Guía para crear servidores MCP
`webapp-testing`	Pruebas de aplicaciones web basadas en Playwright

Vercel

Mejores prácticas de React y Next.js, despliegue y optimización de rendimiento.

Habilidad	Descripción
`react-best-practices`	Directrices de optimización de rendimiento de React
`next-best-practices`	Convenciones y patrones de Next.js
`web-design-guidelines`	Revisión de cumplimiento de UI/UX
`vercel-deploy`	Desplegar aplicaciones en Vercel

Trail of Bits

Análisis de seguridad, auditoría de contratos inteligentes y herramientas de revisión de código.

Habilidad	Descripción
`building-secure-contracts`	Kit de herramientas de seguridad para contratos inteligentes
`semgrep-rule-creator`	Crear reglas personalizadas de Semgrep
`property-based-testing`	Guía de pruebas basadas en propiedades
`static-analysis`	Herramientas de análisis estático

Hugging Face

Entrenamiento de modelos de ML, gestión de conjuntos de datos y operaciones del Hub.

Habilidad	Descripción
`hugging-face-cli`	Operaciones CLI del HF Hub
`hugging-face-datasets`	Creación y gestión de conjuntos de datos
`hugging-face-model-trainer`	Ajuste fino de modelos con TRL
`hugging-face-evaluation`	Flujos de trabajo de evaluación de modelos

Sentry

Revisión de código, convenciones de commits y automatización de PR.

Habilidad	Descripción
`code-review`	Prácticas de revisión de código de ingeniería de Sentry
`commit`	Mensajes de commit convencionales
`create-pr`	Creación de PR siguiendo las convenciones de Sentry
`find-bugs`	Detección de errores y vulnerabilidades

Y Muchas Más...

Stripe - Mejores prácticas de integración de pagos
Expo - Desarrollo de aplicaciones React Native
n8n - Patrones de automatización de flujos de trabajo
Sanity - Mejores prácticas de CMS
Neon - Postgres sin servidor
Remotion - Creación de vídeos programáticos

Herramientas MCP

El servidor expone cuatro herramientas MCP:

`list_skills`

Lista todas las habilidades disponibles con filtrado opcional.

// List all skills
{ }

// Filter by source
{ "source": "repository" }

// Filter by tag
{ "tag": "security" }

`get_skill`

Obtiene información detallada sobre una habilidad específica.

{ "skill_id": "react-best-practices" }

`invoke_skill`

Invoca una habilidad con parámetros opcionales.

{
  "skill_id": "docx",
  "parameters": {
    "document_type": "report"
  }
}

`refresh_skills`

Activa manualmente una actualización de habilidades desde el repositorio.

{ }

Ejemplos de Uso

En GitHub Copilot Chat

@workspace Use the react-best-practices skill to review my React components

@workspace List all available security-related skills

@workspace Get the stripe-best-practices skill and apply it to my checkout code

En Claude

What skills are available for Next.js development?

Use the code-review skill to analyze my pull request

Desarrollo

Configuración

git clone https://github.com/shadowrootdev/awesome-agent-skills-mcp.git
cd awesome-agent-skills-mcp
npm install

Compilación

npm run build

Ejecutar Pruebas

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run integration tests only
npm run test:integration

Lint y Formato

npm run lint
npm run format

Estructura del Proyecto

awesome-agent-skills-mcp/
├── src/
│   ├── index.ts              # Entry point
│   ├── server.ts             # MCP server implementation
│   ├── config.ts             # Configuration management
│   ├── models/
│   │   ├── skill.ts          # Skill type definitions
│   │   ├── parameter.ts      # Parameter schemas
│   │   ├── registry.ts       # SkillRegistry class
│   │   └── repository.ts     # Repository source model
│   ├── services/
│   │   ├── git-sync.ts       # Git repository sync
│   │   ├── skill-parser.ts   # Skill parsing from README
│   │   └── skill-executor.ts # Skill invocation
│   ├── cache/
│   │   └── cache-manager.ts  # JSON-based caching
│   └── utils/
│       └── logger.ts         # Structured logging
├── tests/
│   ├── unit/                 # Unit tests
│   └── integration/          # Integration tests
├── dist/                     # Compiled output
└── .cache/                   # Runtime cache (gitignored)

Referencia de API

Objeto de Habilidad

interface Skill {
  id: string;           // Unique identifier
  name: string;         // Display name
  description: string;  // Short description
  source: 'repository' | 'local';
  sourcePath: string;   // GitHub URL or local path
  content: string;      // Full skill content (markdown)
  parameters: ParameterSchema[];
  metadata: {
    author?: string;
    version?: string;
    tags?: string[];
    requirements?: string[];
    sourceOrg?: string;   // GitHub organization
    sourceRepo?: string;  // GitHub repository
  };
  lastUpdated: Date;
}

Esquema de Parámetros

interface ParameterSchema {
  name: string;
  type: 'string' | 'number' | 'boolean' | 'object' | 'array';
  description: string;
  required: boolean;
  default?: unknown;
  enum?: unknown[];
}

Solución de Problemas

Las Habilidades No Se Cargan

Verifica la caché: Elimina el directorio .cache y reinicia
Verifica la red: Asegúrate de tener acceso a GitHub
Revisa los registros: Establece LOG_LEVEL=debug para una salida detallada

GitHub Copilot No Ve las Habilidades

Se requiere reinicio completo: Cierra VS Code por completo (Cmd+Q) y vuelve a abrirlo
Verifica la ruta de configuración: Asegúrate de que .vscode/mcp.json esté en la raíz del espacio de trabajo
Verifica el servidor: Ejecuta npx awesome-agent-skills-mcp manualmente para probar

Errores de Conexión

# Test the server manually
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | npx awesome-agent-skills-mcp

Créditos

Este proyecto se basa en el increíble trabajo de la comunidad de código abierto:

Fuente de Datos

VoltAgent Awesome Agent Skills - Una colección seleccionada de habilidades de agentes de IA mantenida por VoltAgent. Este servidor MCP obtiene y sirve habilidades de este repositorio, haciéndolas accesibles para asistentes de IA compatibles con MCP.

Contribuyentes de Habilidades

Las habilidades de esta colección son aportadas por organizaciones líderes, incluyendo:

Anthropic - Procesamiento de documentos, generación de arte, creación de MCP
Vercel - React, Next.js, despliegue
Trail of Bits - Análisis de seguridad, contratos inteligentes
Hugging Face - Flujos de trabajo de ML, entrenamiento de modelos
Sentry - Revisión de código, convenciones de commits
Expo - Desarrollo de React Native
Stripe - Integraciones de pagos
¡Y muchos más contribuyentes!

Tecnologías

Model Context Protocol - La especificación del protocolo
@modelcontextprotocol/sdk - SDK oficial de TypeScript
Zod - Validación de esquemas centrada en TypeScript
simple-git - Operaciones de Git

Contribuciones

¡Las contribuciones son bienvenidas! Por favor, lee nuestras directrices de contribución antes de enviar PRs.

Haz un fork del repositorio
Crea tu rama de características (git checkout -b feature/amazing-feature)
Haz commit de tus cambios (git commit -m 'Add amazing feature')
Sube la rama (git push origin feature/amazing-feature)
Abre una Pull Request

Consulta nuestras plantillas de issues para reportar errores, solicitar funciones o hacer preguntas.

Documentación y Demo

GitHub Pages

Puedes habilitar GitHub Pages para alojar documentación interactiva o demos:

Crea tu documentación (recomendado: usa la carpeta /docs):
- Crea un directorio docs/ en la raíz de tu repositorio
- Añade un archivo index.html o usa un generador de sitios estáticos como VitePress o Docusaurus
- Esto mantiene la documentación separada del código fuente
Habilita GitHub Pages:
- Ve a Settings → Pages de tu repositorio
- Selecciona Source: Deploy from a branch
- Elige Branch: main y carpeta /docs (recomendado) o / si vas a desplegar todo el repositorio
- Guarda y espera el despliegue

Esto es útil para:

Documentación interactiva de API
Demos en vivo de las capacidades del servidor MCP
Tutoriales guiados
Navegador del catálogo de habilidades

Nota: Se recomienda usar la carpeta /docs ya que mantiene la documentación organizada y separada del código fuente. Solo usa / (raíz) si quieres desplegar todo el repositorio como un sitio web.

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

Proyectos Relacionados

VoltAgent - Marco de trabajo para agentes de IA
Awesome Agent Skills - La colección de habilidades fuente
MCP Servers - Implementaciones oficiales de servidores MCP

Hecho con ❤️ para la comunidad de agentes de IA
⭐ Da una estrella al repositorio de Awesome Agent Skills