skillmd

SkillMD

リンティングを行うレジストリ。
Claude Code、Cursor、Codex、その他60以上のエージェント向けのエージェントスキル（SKILL.md）を検索、インストール、リント、公開できます。
このリポジトリはskillmd.comを支えるオープンソースのツールチェーンです。CLI、MCP サーバー、GitHub Action、およびそれらが共有するSKILL.mdエンジンが含まれています。

スキルを閲覧 · カテゴリ · 公開者 · インストールガイド · ドキュメント · ブログ · 統計

---

これは何か

エージェントスキルとは、SKILL.mdファイルを含むフォルダーです。YAMLフロントマター（name、description）と、エージェントが必要に応じて読み込むMarkdownの指示で構成されています。Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot、Windsurfをはじめとする数十のエージェントが同じ形式を読み込むため、共有レジストリを用意する価値があります。この形式を初めて知った方は、エージェントスキルとは？とSKILL.mdファイルの構成からご覧ください。

**skillmd.com**は、こうしたスキルのオープンレジストリです。30,000以上の公開者による1,000,000以上のスキルが登録されており、すべて形式に基づくリント、実行可能な機能のセキュリティスキャン、コミットへの固定が行われています。各スキルページには判定結果、機能フラグ、独立したスキャナーの結果が表示されます。インストール時に書き込まれるのはファイルのみで、それ以外の処理は行われません。

このリポジトリには、マシン上またはCIで実行するすべてのものが含まれており、MITライセンスで提供されています。

パッケージ	内容	インストール
skillmds	1つのnpmパッケージに2つのバイナリを同梱：skillmd CLIと**skillmds MCP サーバー**	npm i -g skillmds
@skillmds/core	SKILL.mdエンジン：パーサー、リントルール、セキュリティスキャナー、品質スコア、SARIF / JSON / GitHubフォーマッター	npm i @skillmds/core
skillmds/skillmd/action	GitHub Action：リポジトリ内のすべてのスキルをリントし、結果をGitHub Code Scanningに表示	uses: skillmds/skillmd/action@v1

レジストリでも同じエンジンを適用するため、ローカルでチェックに合格したスキルは公開時にも合格します。

クイックスタート

# Search the registry and install a skill into every agent on your machine
npx skillmds search "pdf"
npx skillmds add anthropic/pdf

# Lint your own skill before you share it
npx skillmds lint ./my-skill

プラグイン

プラグインは、ひとまとまりでインストールされるスキルのバンドルです。Claude Code では実際のプラグインになり、/plugin に表示されます。セット全体を有効化、無効化、アンインストールでき、その他のすべてのエージェントではスキルが個別にインストールされます。

npx skillmds add plugin:skillmd/design

Claude Code の「Plugins」タブから参照するには、次のリポジトリをマーケットプレイスとして追加してください：skillmds/skillmd。ここには主要なプラグインが plugins/ の下に実際のディレクトリとして格納されており、.claude-plugin/marketplace.json に掲載され、毎週更新されます。このタブが扱えるのは Git 内にあるプラグインだけなので、レジストリ全体は含まれていません。その他のプラグインは、上記のコマンドでインストールできます。

上記のいずれにもアカウントは必要ありません。スキルは、検出された各エージェントの専用ディレクトリ（.claude/skills/、.cursor/skills/、.agents/skills/ など）に配置されます。エージェントごとの手順：Claude Code · Cursor · Codex · Gemini CLI · GitHub Copilot · Windsurf · すべてのエージェント。

CLI：skillmd

npm i -g skillmds

コマンド	機能
skillmd lint [path]	SKILL.md ファイルを検証します。診断、0～100 の品質スコア、機械的に修正できる項目向けの --fix を提供します。
skillmd scan [path]	このスキルが何をするかを確認します。スクリプト、ネットワーク呼び出し、シークレットへのアクセスを報告します。
skillmd rules [id]	lint ルールの一覧を表示するか、特定のルールを説明します。
skillmd init [name]	テンプレートから新しいスキルのひな形を作成します。
skillmd search <query>	ターミナルからレジストリを検索します。
skillmd add <source>	レジストリのスラッグ、GitHub リポジトリ、またはローカルパスからインストールします。最初に lint を実行し、スクリプトは実行しません。
skillmd list / remove / update	エージェント間でインストール済みスキルを管理します。
skillmd publish [path]	skillmd.com に公開します。lint エラーがある場合は公開できません。

skillmd lint . --format sarif > skillmd.sarif   # GitHub Code Scanning
skillmd lint . --strict                          # warnings fail too
skillmd add owner/repo -a claude-code -g         # one agent, global scope
skillmd add some/skill --deny executes_scripts   # refuse skills that run code

skillmd add は設定ディレクトリを使って 68 のエージェントを検出します。Claude Code、Cursor、Codex、Windsurf、OpenCode、Gemini CLI、Antigravity、Kiro、Warp、GitHub Copilot、Cline、Roo Code、Goose、Trae、Qwen Code、Amp、Zed、Continue、Devin、OpenHands、Replit などに対応しています。.agents/skills の規約を共有するエージェントには、一度だけ書き込みます。引数なしで skillmd を実行すると、ガイド付きメニューが開きます。

詳細なリファレンス：docs/cli.md · skillmd.com の CLI ドキュメント · 1 つの SKILL.md をすべてのエージェントで使う方法

MCP サーバー：skillmds

MCP 対応のエージェントにレジストリ全体を提供します。会話中にスキルの検索、詳細の確認、lint、インストールができます。

# Claude Code
claude mcp add skillmd -- npx -y skillmds

// Claude Desktop, Cursor, VS Code, Windsurf, … (examples/mcp/ has per-client files)
{ "mcpServers": { "skillmd": { "command": "npx", "args": ["-y", "skillmds"] } } }

または、ホスト型のリモートサーバーをお使いください。インストール不要で、ストリーミング可能な HTTP 接続に対応しています。

https://api.skillmd.com/mcp

ツール	エージェントが利用できる機能
skillmd_search	カテゴリ、評価、インストール用スニペットを含むレジストリ検索
skillmd_get	スキルの全詳細：本文、出所、ライセンス、セキュリティフラグ
skillmd_install	安全なインストール：検証済み、SHA-256 検証済み、zip-slip 対策済み、スクリプトは実行しません
skillmd_trending / skillmd_recommend	ランキングと類似スキルの提案
skillmd_list_saved	保存したスキル（SKILLMD_TOKEN が必要）
skillmd_lint	任意の SKILL.md コンテンツをその場で検証

詳細なリファレンス：docs/mcp.md · skillmd.com の MCP ドキュメント · MCP 経由で SkillMD を使う · MCP レジストリエントリー：com.skillmd/skillmd

エンジン：@skillmds/core

npm i @skillmds/core

import { lint } from "@skillmds/core";

const { ok, score, diagnostics, security } = lint(rawSkillMd, { slug: "my-skill" });

9 つの lint ルール、行を考慮したセキュリティスキャナー、0～100 の品質スコア、SARIF／JSON／GitHub アノテーション形式のフォーマッターを備えています。ESM、型付きで、実行時の依存関係は yaml のみです。Node、ブラウザー、エッジランタイムで動作します。

スキャナーはすべてのスキルを機能フラグに分類します。インストール時にフィルタリングしたり、拒否したりできます。

フラグ	意味
docs_only	実行可能なものは見つかりません。説明のみです。
network_calls	Fetch、curl、その他の方法でネットワークと通信します。
executes_scripts	コマンドまたはバンドルされたスクリプトを実行します。
reads_secrets	環境変数、トークン、認証情報ファイルにアクセスします。
untrusted_install	標準以外のソースから取得して実行します。

ルールとスコアリング：docs/rules.md · スキルのデバッグ：lint、スキャン、スコアリング · よくある SKILL.md の間違い

スキルの CI

- uses: skillmds/skillmd/action@v1
  with:
    path: .

リポジトリ内のすべてのスキルを lint し、SARIF を GitHub Code Scanning にアップロードするため、検出結果がプルリクエストに表示されます。完全な例：examples/github-action.yml · action/README.md

スキルの公開

skillmd login                   # token from your skillmd.com account
skillmd publish ./my-skill      # blocked on lint errors
skillmd publish ./my-skill --dry-run

公開されたスキルには、skillmd.com/skills/<you>/<name> のページ、安全性の判定、各エージェント用のインストールコマンド、README に表示されるライブバッジが用意されます。

[![SkillMD](https://skillmd.com/badge/<you>/<name>.svg)](https://skillmd.com/skills/<you>/<name>)

ガイド：レジストリへのスキルの公開 · 使われるスキルの書き方 · 認証済みバッジの意味 · スキルパック

レジストリ API

ここにあるものはすべて、api.skillmd.com の公開 API（GET /v1/search?q=…、GET /v1/skills/<owner>/<name> など）を利用する薄いクライアントです。docs/registry-api.md、skillmd.com/openapi.json、AI システム向けの skillmd.com/llms.txt に記載されています。各スキルのページには、Markdown 版（…/<name>.md）も用意されています。

レジストリの内容

カテゴリーから探す：コーディング＆開発ツール · AI＆ML · DevOps＆インフラ · インテグレーション＆API · セキュリティ · データ＆分析 · Web＆フロントエンド · 生産性 · ドキュメント＆ライティング · デザイン＆メディア

または、公開者、認証済み公開者による公式スキル、ランキング、新着情報から探せます。リアルタイムの件数はskillmd.com/statsをご覧ください。

セキュリティモデル

スキルのインストールで行われるのは、ファイルの書き込みのみで、それ以外は何も行われません。スクリプトは実行されず、厳格なパス包含チェック（スラッグの検証と zip-slip 対策）、レジストリのコンテンツアドレス指定型ストアとの SHA-256 整合性検証、GitHub の raw ホストに固定された関連ファイルによって保護されています。公開時には CLI と同じ lint とスキャンが実行され、掲載されているすべてのスキルに判定結果、機能フラグ、独立したスキャナーの結果が表示されます。

詳細はSECURITY.mdをご覧ください。脆弱性は [email protected] まで報告してください。

詳細情報

• AI エージェントのスキル完全ガイド
• エージェントスキルと MCP サーバーの比較
• Claude Code のスキル、プラグイン、サブエージェント、コマンドの比較
• Cursor のルールと Cursor のスキルの比較
• オープンなスキル形式を採用する理由
• 用語集 · SKILL.md 形式 · はじめに

開発

npm ci
npm run build      # @skillmds/core, then skillmds
npm test           # vitest across both packages, incl. an MCP stdio smoke test
npm run typecheck  # strict tsc

構成、PR のガイドライン、リリースプロセスについては、CONTRIBUTING.mdとCODE_OF_CONDUCT.mdをご覧ください。

ライセンス

MIT © SkillMD · skillmd.com · [email protected]