awesome-agent-skills

Awesome Agent Skills MCP サーバー

VoltAgent Awesome Agent Skills コレクションから厳選された 100 以上の AI エージェントスキルにアクセスできる Model Context Protocol (MCP) サーバーです。

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

環境変数

変数	デフォルト	説明
SKILLS_REPO_URL	https://github.com/VoltAgent/awesome-agent-skills.git	スキルリポジトリの URL
SKILLS_CACHE_DIR	.cache	キャッシュディレクトリのパス
SKILLS_SYNC_INTERVAL	60	自動同期の間隔 (分単位、0 で無効化)
LOG_LEVEL	info	ログレベル (debug、info、warn、error)

---

利用可能なスキル

このサーバーは、主要な組織が提供する 100 以上のスキル にアクセスできます。

Anthropic

ドキュメント処理、プレゼンテーション作成、スプレッドシート操作、PDF 処理、アルゴリズミックアート、MCP 構築など。

スキル	説明
docx	Word ドキュメントの作成、編集、分析
pptx	PowerPoint プレゼンテーションの作成と編集
xlsx	数式を使用したスプレッドシート操作
pdf	PDF 処理とフォーム入力
mcp-builder	MCP サーバーを作成するためのガイド
webapp-testing	Playwright ベースの Web アプリテスト

Vercel

React と Next.js のベストプラクティス、デプロイ、パフォーマンス最適化。

スキル	説明
react-best-practices	React パフォーマンス最適化ガイドライン
next-best-practices	Next.js の規約とパターン
web-design-guidelines	UI/UX コンプライアンスレビュー
vercel-deploy	アプリを Vercel にデプロイ

Trail of Bits

セキュリティ分析、スマートコントラクト監査、コードレビューツール。

スキル	説明
building-secure-contracts	スマートコントラクトセキュリティツールキット
semgrep-rule-creator	カスタム Semgrep ルールの作成
property-based-testing	プロパティベーステストのガイダンス
static-analysis	静的解析ツール

Hugging Face

ML モデルのトレーニング、データセット管理、Hub の操作。

スキル	説明
hugging-face-cli	HF Hub CLI の操作
hugging-face-datasets	データセットの作成と管理
hugging-face-model-trainer	TRL を使用したモデルのファインチューニング
hugging-face-evaluation	モデル評価ワークフロー

Sentry

コードレビュー、コミット規約、PR の自動化。

スキル	説明
code-review	Sentry エンジニアリングのコードレビュー慣行
commit	Conventional Commit メッセージ
create-pr	Sentry の規約に従った PR 作成
find-bugs	バグと脆弱性の検出

その他多数...

• Stripe - 決済統合のベストプラクティス
• Expo - React Native アプリ開発
• n8n - ワークフロー自動化パターン
• Sanity - CMS のベストプラクティス
• Neon - サーバーレス Postgres
• Remotion - プログラムによる動画作成

---

MCP ツール

このサーバーは 4 つの MCP ツールを公開しています。

list_skills

オプションのフィルタリングを使用して、利用可能なすべてのスキルを一覧表示します。

// List all skills
{ }

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

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

get_skill

特定のスキルに関する詳細情報を取得します。

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

invoke_skill

オプションのパラメータを指定してスキルを呼び出します。

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

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

パラメータスキーマ

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

---

トラブルシューティング

スキルが読み込まれない

1. キャッシュを確認: .cache ディレクトリを削除して再起動します
2. ネットワークを確認: GitHub へのアクセスを確保します
3. ログを確認: 詳細な出力を得るには LOG_LEVEL=debug を設定します

GitHub Copilot がスキルを認識しない

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 エージェントスキルのキュレーションされたコレクションです。この MCP サーバーは、このリポジトリからスキルを取得して提供し、MCP 互換の AI アシスタントから利用できるようにします。

スキルのコントリビューター

このコレクションのスキルは、以下をはじめとする主要な組織によって提供されています。

• Anthropic - ドキュメント処理、アート生成、MCP 構築
• Vercel - React、Next.js、デプロイ
• Trail of Bits - セキュリティ分析、スマートコントラクト
• Hugging Face - ML ワークフロー、モデルトレーニング
• Sentry - コードレビュー、コミット規約
• Expo - React Native 開発
• Stripe - 決済連携
• その他、多数のコントリビューター！

テクノロジー

• Model Context Protocol - プロトコル仕様
• @modelcontextprotocol/sdk - 公式 TypeScript SDK
• Zod - TypeScript ファーストのスキーマバリデーション
• simple-git - Git 操作

---

コントリビューション

コントリビューションを歓迎します！PR を送信する前に、コントリビューションガイドライン をお読みください。

1. リポジトリをフォークする
2. フィーチャーブランチを作成する（git checkout -b feature/amazing-feature）
3. 変更をコミットする（git commit -m 'Add amazing feature'）
4. ブランチにプッシュする（git push origin feature/amazing-feature）
5. プルリクエストを開く

バグの報告、機能のリクエスト、質問については、Issue テンプレート をご覧ください。

---

ドキュメントとデモ

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 サーバー機能のライブデモ
• チュートリアルのウォークスルー
• スキルカタログブラウザー

Note: ドキュメントを整理された状態でソースコードから分離して保つことができるため、/docs フォルダーの使用を推奨します。リポジトリ全体をウェブサイトとしてデプロイしたい場合にのみ /（ルート）を使用してください。

---

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています - 詳細は LICENSE ファイルをご覧ください。

---

関連プロジェクト

• VoltAgent - AI エージェントフレームワーク
• Awesome Agent Skills - ソースとなるスキルコレクション
• MCP Servers - 公式 MCP サーバー実装

---

Made with ❤️ for the AI agent community
⭐ Star the Awesome Agent Skills repository