skill-deck

SkillDeck

中文 · English · 公式サイト · クイックスタート · GitHub

ローカルに散在する Agent Skills を、モデルが見つけて使え、共有もできるスキルデッキに変えます。
ランタイム向けのアダプター、MCP による動的な検出、エージェントとの会話を通じて生成される共有用アーティファクト。

SkillDeck は、ローカルの Agent Skill を適応、アクティブ化、共有するためのツールです。

次の3つの具体的なシナリオを解決します。

シナリオ	必要な理由	SkillDeck の機能
ツールとして OpenAI Agent SDK に接続したい Skill がある。	OpenAI は SKILL.md を再利用可能なワークフローとして定義しており、Agents SDK もローカルスキルをサポートしていますが、schema、handler、stable id を手作業で作成するのは手間がかかります。	アダプターが SKILL.md をスキャン、解析、検証し、プロバイダーに依存しないツールとランタイムハンドラーを生成します。同じ Skills を異なる Agent ランタイムに接続できます。
Claude Code、Cursor、その他の MCP host に接続したい Skill がある。	list_skills / read_skill だけでは不十分です。複雑なタスクで、モデルがローカル Skills を先に調べるとは限りません。	MCP + Skill Activation により、Skills をツール／リソースとして公開し、compact / guided / active の3つのモードを通じて、モデルがタスク内で Skill を自ら検出、検索、読み込みできるようにします。
同僚や同業者、ソーシャルプラットフォームで共有したい Skill がある。	プライベートな Skill にはローカルパス、secret、プライベート URL が含まれていることが多く、スクリーンショットだけを共有しても検索、詳細表示、再利用ができません。	Share は MCP を通じて、エージェントに完全な共有ページと2枚の画像を生成させます。デフォルトで機密情報を除去するため、検索、詳細表示、確認を経てから接続できます。

背景資料：OpenAI Skills guide、Skills in ChatGPT、Agents SDK tools、openai-agents-python #2906。

製品の機能としては、次の3つを提供します。

主な機能	役割	得られること
Adapter	ローカルの SKILL.md をスキャン、解析、検証し、stable id、プロバイダーに依存しないツール、ランタイムハンドラーを生成します。	同じ Skills を OpenAI、Anthropic、OpenAI Agents SDK、ローカルランタイムに接続できます。
MCP	Skills を MCP のツール／リソースとして公開し、Skill Activation を通じてモデルによる動的な検出を支援します。	モデルは skill_guide、use_skill_*、search_skills、read_skill を使って Skill を読み込めます。
Share	エージェントに「この Skills を共有して」と伝えると、エージェントが MCP を通じて静的な共有ページと2枚の画像を生成します。デフォルトで機密情報を除去します。	SNS、RED、小紅書や同業者との交流に適しており、ローカルパス、secret、プライベート URL を公開しません。

公開マーケットプレイスでも、リモートホスティングサービスでもありません。ユーザーの Skill ディレクトリは引き続きローカルにあります。

Skill Activation

デフォルトの list_skills / read_skill で Skill を読み取れますが、モデルが自発的に呼び出すとは限りません。SkillDeck では3つのモードを追加し、モデルがローカルの Skill を見つけて読み込みやすくしています。

モード	公開される内容	モデルによる Skill の検出方法	適した場面	デメリット
compact	list_skills、search_skills、get_skill_info、read_skill、リソース	モデルが自分で検索するか、一覧を表示する必要があります	以前の動作との互換性、Skill が多い場合、ツール一覧を短くしたい場合	自動検出機能が弱い
guided	compact + skill_guide + MCP instructions	モデルは skill_guide を見ると、使用ガイドを利用できます	検出率を高めたいものの、各 Skill をツールにしたくない場合	引き続きモデルがガイドを呼び出す必要があります
active	guided + 最大 N 個の use_skill_<safe_name>_<short_id>	モデルは tools/list の段階で、よく使う Skill を直接確認できます	自動検出効果を最大化したい場合	ツール数が増えます

例：

npx -y skill-deck mcp serve \
  --skills ~/.skills

インストール

インストール：

npm install skill-deck

MCP の3ステップ接続

ステップ1：Skill Activation モードを選択して MCP をインストールします。まずはデフォルトの active をおすすめします。

3つのコマンドで MCP サーバー名はすべて skill-deck です。モードを切り替える場合は、同じ名前のサーバーを更新するだけです。

# active：默认模式，常用 Skill 会直接出现在 tools/list
claude mcp add skill-deck \
  -- npx -y skill-deck mcp serve \
  --skills ~/.codex/skills

# guided：暴露 skill_guide，让模型先看分组和推荐入口
claude mcp add skill-deck \
  -- npx -y skill-deck mcp serve \
  --skills ~/.codex/skills \
  --skill-mode guided

# compact：只暴露 list/search/info/read/resources，工具列表最短
claude mcp add skill-deck \
  -- npx -y skill-deck mcp serve \
  --skills ~/.codex/skills \
  --skill-mode compact

Codex / その他の MCP host でも同じ stdio 引数を使用します。モードを切り替える場合は、args に --skill-mode と対応する値を追加してください。

{
  "mcpServers": {
    "skill-deck": {
      "command": "npx",
      "args": [
        "-y",
        "skill-deck",
        "mcp",
        "serve",
        "--skills",
        "~/.codex/skills"
      ]
    }
  }
}

ステップ2：Claude / Codex で skill-deck が接続されていることを確認します。Claude Code で次のように入力してください。

/mcp

ステップ3：エージェントにそのまま話しかけてください。

请使用 SkillDeck MCP 的 generate_skill_share 工具，为当前已加载的 ~/.codex/skills 生成一套可以分享给同行看的 Skill 工作流分享物。

出力ディレクトリを指定する場合は、さらに次のように追加してください。

输出到 ~/skilldeck-shares/codex-skills-share，注意脱敏，并在完成后告诉我 index.html、cover.png、detail.png 和 manifest.json 的路径。

共有

共有のために設定を手書きしたり、非公開の Skill を公開マーケットに投稿したりする必要はありません。エージェントと会話するだけです。

帮我把 ~/.skills 这套 Skills 做成一个可以发给同行看的分享页和两张分享图，注意脱敏。

エージェントは SkillDeck の MCP Share インターフェースを使って、次のものを生成します。

share/
  index.html
  cover.png
  detail.png

index.html は検索と Skill の詳細表示に対応した紹介ページです。cover.png は共有に、detail.png は技術的な詳細を同業者に見せるのに適しています。デフォルトではローカルパス、secret、非公開 URL を削除し、reference にはパスのみを表示して、ファイルの内容は読み取りません。

実際の生成例：

全機能

• Skill Activation：compact / guided / active。
• skill_guide と use_skill_*。
• 検索の並べ替え、ページネーション、フィールドの絞り込み。
• Catalog/resources。
• watcher。
• symlink の明示的なサポート。
• Share HTML + 画像2枚。
• docs-site の右上に検索機能。
• npm パッケージ：skill-deck。
• MCP Registry：server.json + npm/stdio メタデータ。
• MCP Streamable HTTP transport。

ドキュメント

• クイックスタート
• Agent SDK 接続
• MCP 接続

詳しいオンラインドキュメントは skill.counterxing.top をご覧ください。

ライセンス

MIT