skill-builder-mcp

skill-builder

コマンドラインから AI スキルのプロンプトを公開してインストールできます。または、AI 下書きアシスタントのサポートを受けながら、ウェブエディターで作成できます。

npx @dmzagent/skill-builder install @author/skill-id

---

はじめに：スキルのインストール

レジストリを閲覧する

結果は、ターミナルに見やすく整理された表形式で表示されます。

npx @dmzagent/skill-builder list

カテゴリ、作成者、タイプ、タグで絞り込み、並べ替え順を指定できます。

npx @dmzagent/skill-builder list --category "Developer Tools"
npx @dmzagent/skill-builder list --type meta          # only meta skills
npx @dmzagent/skill-builder list --author skillauthor
npx @dmzagent/skill-builder list --sort downloads
npx @dmzagent/skill-builder list --json               # machine-readable
npx @dmzagent/skill-builder list --web                # open the browser registry instead

検索して詳細を確認する

npx @dmzagent/skill-builder search "data pipeline"    # ranked by relevance
npx @dmzagent/skill-builder info @skillauthor/dialogue-flow
npx @dmzagent/skill-builder suggest dial              # autocomplete: skills, tags, authors

シェル補完を設定できます（入力中にスキル、タグ、作成者が補完されます）。

npx @dmzagent/skill-builder completion >> ~/.bashrc

スキルをインストールする

npx @dmzagent/skill-builder install dialogue-flow
npx @dmzagent/skill-builder install @skillauthor/dialogue-flow

dialogue-flow.md と dialogue-flow.json を現在のディレクトリにダウンロードします。ファイルの保存先を変更するには、--output ./my-skills を使用します。

メタスキルのインストール時には、依存関係が自動的にインストールされます。 メタスキルをインストールすると、依存関係ツリー全体を解決し（重複排除され、循環にも対応）、必要なすべてのスキルを併せてインストールします。メタスキルだけをインストールするには、--no-deps を使用します。

npx @dmzagent/skill-builder install @skillauthor/my-bundle
# → resolves and installs my-bundle + every skill it depends on

---

はじめに：スキルの公開

1. アカウントを作成する

npx @dmzagent/skill-builder register myhandle "My Name" [email protected]

パスワードの入力を求められます。または、SKILL_PASSWORD を設定すると、入力を省略できます。

SKILL_PASSWORD=hunter2 npx @dmzagent/skill-builder register myhandle "My Name" [email protected]

2. ログインする

npx @dmzagent/skill-builder login [email protected]

認証トークンは、ログインに成功すると表示されます。以降のコマンドで使用できるよう、SKILL_TOKEN に設定します。

export SKILL_TOKEN=<token-from-login>

（または、各コマンドに --token $SKILL_TOKEN を渡します。）

3. スキルを公開する

Markdown ファイルから公開する場合：

npx @dmzagent/skill-builder publish ./my-skill.md

CLI はファイル名をスキル ID として、最初の見出しを名前として読み取ります。JSON マニフェストも使用できます。

npx @dmzagent/skill-builder publish ./my-skill.json

4. スキルに必要な機能を宣言する（任意）

スキルを呼び出すためにモデルが実行できる必要のある機能を宣言できます。この宣言は仕様に含まれるため、レジストリ、CLI、MCP を通じてスキルとともに受け渡されます。エージェントは、スキルの実行に処理時間を費やす前に、そのスキルを実行できるかどうかを判断できます。

{
  "capabilities": [
    { "id": "vision", "level": "required", "note": "reads chart images" },
    { "id": "long-context", "level": "preferred" }
  ]
}

required 機能は実行を制限します。呼び出し側が明示的に機能を制限した実行を強制しない限り、レジストリは必要な機能を提供できないランタイムでのスキル実行を拒否します。preferred 機能は結果の品質を下げるだけです。カタログの ID は次のとおりです。

vision · audio-input · file-input · structured-output · streaming
extended-reasoning · long-context · multilingual
tool-use · parallel-tool-calls · code-execution · web-search · file-system
computer-use · mcp-client
persistent-memory · citations

カタログにまだ定義されていない機能には、カスタム ID を指定できます。info と list には機能の要件が表示され、install はメタスキルの依存関係ツリー全体を集約します。メタスキルは、インストールするすべてのスキルを実行できる環境でのみ実行されます。

npx @dmzagent/skill-builder info @skillauthor/chart-reader
# Required capabilities (1) — the invoking model must provide these:
#   - vision (required) — reads chart images

5. 既存のスキルをフォークする（任意）

npx @dmzagent/skill-builder fork @skillauthor/dialogue-flow --name my-dialogue

アカウント内にコピーを作成し、再公開できるようにします。

---

レジストリの保守：依存関係のバックフィル

scripts/backfill-dependencies.mjs は、他のスキルを暗黙的にオーケストレーションしている既存のスキルを見つけ、明示的な dependencies と type: "meta" の追加を提案します。すべてのスキルを読み込み、他の実在するレジストリスキルへの参照（完全な ID、install ディレクティブ、または特徴的な名前）を検出して確度を評価し、正しいことが確認されたマッピングをまとめたリストとマージします。

デフォルトではドライランです。レポートを表示しますが、何も書き込みません。

node scripts/backfill-dependencies.mjs                 # report only
node scripts/backfill-dependencies.mjs --json          # machine-readable

適用するには、トークンとともに --apply を渡します。更新されるのはトークンのアカウントが所有するスキルだけです（それ以外は一覧表示され、スキップされます）。そのため、公開アカウントごとに一度実行してください。

SKILL_TOKEN=<token> node scripts/backfill-dependencies.mjs --apply
node scripts/backfill-dependencies.mjs --apply --include-medium   # also apply medium-confidence

確度の区分：curated と high（明示的な ID、install、特徴的な名前による参照）はデフォルトで適用されます。medium（あいまいな名前の一致）は --include-medium を指定した場合にのみ適用されます。meta-no-deps（オーケストレーションを示す記述はあるものの、具体的な依存関係がないもの）は手動確認用に報告され、自動適用されることはありません。

適用するには、type／dependencies を理解するワーカービルドでレジストリを実行する必要があります（保存時に type を導出し、Markdown を再生成します）。 ドライランのレポートは、デプロイ済みのどのバージョンでも動作します。

---

コーディングエージェントから使用する（MCP）

Claude Code、Cursor、Codex、その他の MCP クライアントなどのコーディングエージェントは、@dmzagent/skill-builder-mcp MCP サーバーを介してレジストリを検索し、スキルを自動インストールできます（メタスキルの依存関係ツリーを解決します）。

// e.g. .mcp.json (Claude Code) or .cursor/mcp.json (Cursor)
{
  "mcpServers": {
    "skill-builder": { "command": "npx", "args": ["-y", "@dmzagent/skill-builder-mcp"] }
  }
}

ツール：skill_search、skill_info、skill_suggest、skill_taxonomy、skill_install（検出されたツール向けのスキルファイルを書き込みます）。クライアントごとのセットアップについては、packages/mcp/README.md をご覧ください。

---

Web アプリ

https://skills.dmzagent.com のスキルスタジオにアクセスしてください。ワークスペースは、折りたたみ可能な 3 つのペインと設定ドロワーで構成されています。

• スキルアーキテクト — Markdown を返すのではなく仕様を直接編集するエージェントです。仕様に不足している内容に応じて、次のステップを提案します。
• 仕様キャンバス — ドキュメントとしてのスキルです。機能コントラクト、手順、{{variables}} が強調表示されたプロンプトテンプレート、例とテスト、各不足項目の詳細に移動できる公開準備チェックリストが含まれます。
• プレビュー — スキルを実際に実行します。テンプレート変数は入力欄になり、機能の事前チェックでランタイムが確実に実行できるかを示します。また、各実行は、その元となった期待値に照らして評価されます。どの実行結果もアーキテクトに渡してレビューできます。
• アーキテクチャ — メタスキルでは、依存関係ツリーをレイヤー構造のグラフで表示し、未解決の ID と循環依存にフラグを立てます。また、スキルがインストールするすべての要素にわたる機能コントラクトを集約して表示します。
• 設定ドロワー — 仕様のすべての項目を、必要になるまで表示しないようにできます。ID、動作、機能、構成、例とテスト、生成された Markdown 成果物を設定できます。

ソースからインストールする

npm install
npm run dev --workspace packages/web

ライセンス

MIT