awesome-agent-skills

Awesome Agent Skills MCP 服务

一个 Model Context Protocol (MCP) 服务，可访问来自 VoltAgent Awesome Agent Skills 集合的 100+ 精选 AI Agent 技能。

利用来自 Anthropic、Vercel、Trail of Bits、Hugging Face、Stripe、Expo 等众多领先组织的技能，将你的 AI 助手转变为专业专家。

🚀 快速开始

npx awesome-agent-skills-mcp

就是这样！添加到你的 MCP 客户端配置中，即可开始使用 100+ AI 技能。

---

目录

• 功能
• 快速开始
• 安装
• 配置
  • VS Code / GitHub Copilot
  • Claude Desktop
  • OpenCode
• 可用技能
• MCP 工具
• 使用示例
• 开发
• API 参考
• 故障排除
• 致谢
• 许可证

---

功能

• 100+ 精选技能 - 访问来自顶级组织的技能，包括 Anthropic、Vercel、Trail of Bits、Hugging Face 等
• 自动同步 - 自动从 VoltAgent 仓库获取并更新技能
• 兼容 MCP 2024-11-05 - 与最新的 Model Context Protocol 规范完全兼容
• 多客户端支持 - 适用于 Claude、GitHub Copilot、OpenCode 以及任何兼容 MCP 的客户端
• 智能缓存 - 基于 JSON 的高效缓存，实现快速启动
• 类型安全 - 使用 TypeScript 和 Zod 构建，支持运行时验证
• 零配置 - 开箱即用，配有合理的默认值

---

快速开始

使用 npx（推荐）

npx awesome-agent-skills-mcp

全局安装

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

---

安装

前置条件

• Node.js >= 20.0.0
• npm 或 yarn

从 npm 安装

npm install awesome-agent-skills-mcp

从源码安装

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

---

配置

VS Code / GitHub Copilot

在项目中创建或更新 .vscode/mcp.json：

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

或使用本地安装：

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

重要：添加配置后，请完全退出 VS Code（Cmd+Q / Alt+F4）并重新打开，以使更改生效。

Claude Desktop

添加到你的 Claude Desktop 配置中（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

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

OpenCode

添加到 ~/.config/opencode/opencode.json：

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

环境变量

Variable	Default	Description
SKILLS_REPO_URL	https://github.com/VoltAgent/awesome-agent-skills.git	Skills 仓库 URL
SKILLS_CACHE_DIR	.cache	缓存目录路径
SKILLS_SYNC_INTERVAL	60	自动同步间隔（分钟，0 表示禁用）
LOG_LEVEL	info	日志级别（debug、info、warn、error）

---

可用的 Skills

该服务提供对来自领先组织的 100+ 个 skills 的访问：

Anthropic

文档处理、演示文稿创建、电子表格操作、PDF 处理、算法艺术、MCP 构建等。

Skill	Description
docx	创建、编辑和分析 Word 文档
pptx	PowerPoint 演示文稿创建和编辑
xlsx	带公式的电子表格操作
pdf	PDF 处理和表单填写
mcp-builder	创建 MCP 服务的指南
webapp-testing	基于 Playwright 的 Web 应用测试

Vercel

React 和 Next.js 最佳实践、部署和性能优化。

Skill	Description
react-best-practices	React 性能优化指南
next-best-practices	Next.js 约定和模式
web-design-guidelines	UI/UX 合规性审查
vercel-deploy	将应用部署到 Vercel

Trail of Bits

安全分析、智能合约审计和代码审查工具。

Skill	Description
building-secure-contracts	智能合约安全工具包
semgrep-rule-creator	创建自定义 Semgrep 规则
property-based-testing	基于属性的测试指南
static-analysis	静态分析工具

Hugging Face

机器学习模型训练、数据集管理和 Hub 操作。

Skill	Description
hugging-face-cli	HF Hub 命令行操作
hugging-face-datasets	数据集创建和管理
hugging-face-model-trainer	使用 TRL 进行模型微调
hugging-face-evaluation	模型评估工作流

Sentry

代码审查、提交约定和 PR 自动化。

Skill	Description
code-review	Sentry 工程代码审查实践
commit	约定式提交消息
create-pr	遵循 Sentry 约定创建 PR
find-bugs	Bug 和漏洞检测

还有更多……

• Stripe - 支付集成最佳实践
• Expo - React Native 应用开发
• n8n - 工作流自动化模式
• Sanity - CMS 最佳实践
• Neon - 无服务器 Postgres
• Remotion - 程序化视频创建

---

MCP 工具

该服务公开四个 MCP 工具：

list_skills

列出所有可用的 skills，支持可选过滤。

// List all skills
{ }

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

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

get_skill

获取特定 skill 的详细信息。

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

invoke_skill

使用可选参数调用 skill。

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

refresh_skills

手动触发从仓库刷新 skills。

{ }

---

使用示例

在 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

在 Claude 中

What skills are available for Next.js development?

Use the code-review skill to analyze my pull request

---

开发

设置

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

构建

npm run build

运行测试

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run integration tests only
npm run test:integration

Lint 和格式化

npm run lint
npm run format

项目结构

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)

---

API 参考

Skill 对象

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;
}

参数 Schema

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

---

故障排除

Skills 未加载

1. 检查缓存：删除 .cache 目录并重启
2. 验证网络：确保可以访问 GitHub
3. 检查日志：设置 LOG_LEVEL=debug 以获取详细输出

GitHub Copilot 看不到 Skills

1. 需要完全重启：完全退出 VS Code（Cmd+Q）并重新打开
2. 检查配置路径：确保 .vscode/mcp.json 位于工作区根目录
3. 验证服务：手动运行 npx awesome-agent-skills-mcp 进行测试

连接错误

# 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

---

致谢

本项目建立在开源社区的杰出工作之上：

数据源

VoltAgent Awesome Agent Skills - 由 VoltAgent 维护的精选 AI Agent 技能集合。此 MCP 服务从该仓库获取并提供技能，使其可供兼容 MCP 的 AI 助手使用。

技能贡献者

此集合中的技能由以下领先组织贡献：

• Anthropic - 文档处理、艺术生成、MCP 构建
• Vercel - React、Next.js、部署
• Trail of Bits - 安全分析、智能合约
• Hugging Face - 机器学习工作流、模型训练
• Sentry - 代码审查、提交约定
• Expo - React Native 开发
• Stripe - 支付集成
• 以及更多贡献者！

技术

• Model Context Protocol - 协议规范
• @modelcontextprotocol/sdk - 官方 TypeScript SDK
• Zod - TypeScript 优先的模式验证
• simple-git - Git 操作

---

贡献

欢迎贡献！在提交 PR 之前，请阅读我们的贡献指南。

1. Fork 仓库
2. 创建你的功能分支（git checkout -b feature/amazing-feature）
3. 提交你的更改（git commit -m 'Add amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开 Pull Request

查看我们的议题模板以报告 bug、请求功能或提问。

---

文档与演示

GitHub Pages

你可以启用 GitHub Pages 来托管交互式文档或演示：

1. 创建你的文档（推荐：使用 /docs 文件夹）：

   • 在仓库根目录创建 docs/ 目录
   • 添加 index.html 文件，或使用 VitePress 或 Docusaurus 等静态站点生成器
   • 这样可以将文档与源代码分开

2. 启用 GitHub Pages：

   • 转到仓库的 Settings → Pages
   • 选择 Source：Deploy from a branch
   • 选择 Branch：main 和文件夹 /docs（推荐）或 /（如果要部署整个仓库）
   • 保存并等待部署

这适用于：

• 交互式 API 文档
• MCP 服务能力的实时演示
• 教程演练
• 技能目录浏览器

注意：建议使用 /docs 文件夹，因为它可以保持文档井然有序并与源代码分开。只有当你想要将整个仓库作为网站部署时，才使用 /（根目录）。

---

许可证

本项目根据 MIT 许可证授权 - 详情请参见 LICENSE 文件。

---

相关项目

• VoltAgent - AI Agent 框架
• Awesome Agent Skills - 源技能集合
• MCP Servers - 官方 MCP 服务实现

---

用 ❤️ 为 AI Agent 社区打造
⭐ 为 Awesome Agent Skills 仓库加星