Skillry MCP ツールリファレンス

接続済み MCP クライアントから呼び出せます。通常は Agent が引数を設定します。この資料は呼び出しの確認や連携開発向けです。

skillry-cli@lateststdioskills:read

確認日：2026年10月26日

呼び出す前に

クライアントに追加

Skillry は Node.js 22+ を備えた macOS または Windows 上のローカル stdio サーバーを使います。認証情報は OS の資格情報ストアに保存します。/mcp は設定ページで、リモート MCP エンドポイントではありません。

アカウントと認証

アカウント操作は skills:read のブラウザー認証を使います。現在の認証情報は 7 日で失効し、自動更新はありません。同じ PC の CLI と MCP は同じサービス URL の認証情報を共有し、接続解除するとその認証情報が取り消されます。

インストール前に要件とアクセス権を確認し、ユーザーが選んだ Skill と版を維持します。インストールでは Skill の実行、アクセス権購入、外部サービスへの支払いは行いません。

<skill-slug> は search_skills の結果の slug、<published-version> は選んだ公開版に置き換えます。パスは自分の PC の絶対パスを使います。

検索と確認

search_skills

公開

目的の成果物と明示された条件で公開 Skill を検索します。既定はキーワード検索で、候補への一致は現在の環境で実行できる保証ではありません。

引数9

querystring任意

目的の成果物または正確な名前／slug。入力 PDF や URL ではなく、欲しい出力を指定します。

maxLength: 200 · 既定値 ""

outputTypestring任意

目的の出力形式で絞り込みます。プレゼンテーションの API 値は presentation です。

deliveryScopestring任意

完成品かコンポーネントかを指定します。交付範囲の情報がない場合は確認が必要です。

complete | component

avoidVoiceoverboolean任意

true にすると、主要工程にナレーションが必要と明示した候補を除外します。

allowApiKeysboolean任意

false にすると、プロバイダー Key が必須と明示した候補を除外します。未記載は不明のままです。

allowExternalCostsboolean任意

false にすると、外部費用を明示した候補を除外します。不明な費用は別途確認します。

limitinteger任意

1 回の最大件数。このツールの範囲と既定値に従います。

≥ 1 · ≤ 20 · 既定値 5

offsetinteger任意

ページの開始位置。続行には返された nextOffset を使います。

≥ 0 · ≤ 10000 · 既定値 0

localestring任意

コンテンツの言語。zh-CN、zh-TW、pt-BR などの API 値を正確に指定します。

en | zh-CN | zh-TW | ja | ko | es | pt-BR | de | fr · 既定値 "en"

引数の例 · JSON

{
  "query": "product presentation",
  "outputType": "presentation",
  "avoidVoiceover": true,
  "allowApiKeys": false,
  "allowExternalCosts": false,
  "limit": 3
}

結果と動作

skills、nextOffset、検索・要確認状態を返します。appliedRequirements、requirementReview、costNotice、clarificationQuestion を確認します。不明な要件は確認が必要です。constraintsStatus: unconfirmed は条件適用をサーバーが確認していない状態です。スコアは確率ではありません。

get_skill

公開

選択前に公開 Skill の版、プレビュー、入力、依存関係、外部費用を確認します。

引数1

slugstring必須

選んだ公開 Skill の正確な slug。小文字の kebab-case で最大 64 文字です。

minLength: 1 · maxLength: 64

引数の例 · JSON

{
  "slug": "<skill-slug>"
}

結果と動作

公開版メタデータを返します。アクセス権付与や非公開パッケージ内容の提供は行いません。

アカウントと認証

connect_account

ブラウザー認証フロー

ユーザーが接続を求めたときにブラウザー認証を開始します。進行中のフローがあれば再利用します。

引数引数はありません。空のオブジェクトを渡します。

結果と動作

verificationUrl、userCode、expiresAt、browserOpened、pollAfterSeconds を返します。URL と照合コードをユーザーに示します。認証情報は返しません。

connection_status

ブラウザー認証フロー

認証フローを続行します。返された pollAfterSeconds の間隔を守って再度呼び出します。

引数引数はありません。空のオブジェクトを渡します。

結果と動作

not_started、pending、denied、expired、connected を返します。承認後、認証情報を OS の資格情報ストアに保存します。ポーリング間隔を守ってください。

account_status

アカウントが必要

現在の会員状態、認証期限、権限、日次ダウンロード上限を確認します。

引数引数はありません。空のオブジェクトを渡します。

結果と動作

connected、entitlement、scope、sessionExpiresAt、quota、pricingUrl を返します。個人情報や認証情報は含みません。

disconnect_account

アカウントが必要

待機中の認証を中止し、共有 CLI/MCP 認証情報を失効させて OS の資格情報ストアから削除します。

引数引数はありません。空のオブジェクトを渡します。

結果と動作

serverRevoked を確認します。リモート失効に失敗してもローカル情報は削除されますが、サーバーのトークンは期限まで有効な場合があります。

get_skill_access

アカウントが必要

ダウンロード前に公開 Skill のアクセス権を確認します。上限枠の予約や消費はありません。

引数1

slugstring必須

選んだ公開 Skill の正確な slug。小文字の kebab-case で最大 64 文字です。

minLength: 1 · maxLength: 64

引数の例 · JSON

{
  "slug": "<skill-slug>"
}

結果と動作

access（free、purchased、member、purchase_required）、canDownload、reason、purchaseUrl、version、quota を返します。権限はダウンロード時に再確認します。

ダウンロード・インストール・更新

download_skill

アカウントが必要ローカルファイルを変更

検証済み ZIP を指定した絶対パスのフォルダーに保存します。既存ファイルは上書きしません。

引数3

slugstring必須

選んだ公開 Skill の正確な slug。小文字の kebab-case で最大 64 文字です。

minLength: 1 · maxLength: 64

downloadDirectorystring必須

ZIP を保存する明示的な絶対パス。Agent やインストール範囲は使いません。

maxLength: 4096

expectedVersionstring任意

選んだ公開版。更新時は必須、インストール／ダウンロードでは任意です。公開版が変わったら再確認します。

minLength: 1 · maxLength: 64

引数の例 · JSON

{
  "slug": "<skill-slug>",
  "downloadDirectory": "/absolute/path/downloads",
  "expectedVersion": "<published-version>"
}

結果と動作

ZIP と版の検証後、archivePath、slug、version、sha256 を返します。インストールや完了報告は行いません。

install_skill

アカウントが必要ローカルファイルを変更

選んだ版を明示した Agent と範囲にインストールします。既存の Skill フォルダーは上書きしません。

引数5

slugstring必須

選んだ公開 Skill の正確な slug。小文字の kebab-case で最大 64 文字です。

minLength: 1 · maxLength: 64

agentstring必須

インストール先の Agent。MCP ホスト名とは別です。global は各 Skills フォルダー、project は shared または claude-code のみです。

scopestring任意

global は現在の OS ユーザー向け、project は明示した projectDirectory 配下へのインストールです。

global | project · 既定値 "global"

projectDirectorystring任意

プロジェクトの絶対パス。scope: project で必須、scope: global では指定不可。shared は .agents/skills、claude-code は .claude/skills を使います。

maxLength: 4096

expectedVersionstring任意

選んだ公開版。更新時は必須、インストール／ダウンロードでは任意です。公開版が変わったら再確認します。

minLength: 1 · maxLength: 64

引数の例 · JSON

{
  "slug": "<skill-slug>",
  "agent": "shared",
  "scope": "global",
  "expectedVersion": "<published-version>"
}

結果と動作

targetPath、skillFile、version、completionReported、inventoryRecorded を返します。実行前に SKILL.md と費用を確認してください。

list_installed_skills

ローカルファイル

指定したローカルフォルダーの Skill を読み取ります。公開版を記録できるのは Skillry 管理のインストールです。

引数3

agentstring必須

インストール先の Agent。MCP ホスト名とは別です。global は各 Skills フォルダー、project は shared または claude-code のみです。

scopestring任意

global は現在の OS ユーザー向け、project は明示した projectDirectory 配下へのインストールです。

global | project · 既定値 "global"

projectDirectorystring任意

プロジェクトの絶対パス。scope: project で必須、scope: global では指定不可。shared は .agents/skills、claude-code は .claude/skills を使います。

maxLength: 4096

引数の例 · JSON

{
  "agent": "shared",
  "scope": "global"
}

結果と動作

ローカル項目と managed/version 状態を返します。管理外 Skill の版は不明で、無断更新はできません。

check_updates

ローカルファイル

管理対象のインストールを公開版と比較します。この確認ではダウンロードや更新は行いません。

引数5

agentstring必須

インストール先の Agent。MCP ホスト名とは別です。global は各 Skills フォルダー、project は shared または claude-code のみです。

scopestring任意

global は現在の OS ユーザー向け、project は明示した projectDirectory 配下へのインストールです。

global | project · 既定値 "global"

projectDirectorystring任意

プロジェクトの絶対パス。scope: project で必須、scope: global では指定不可。shared は .agents/skills、claude-code は .claude/skills を使います。

maxLength: 4096

offsetinteger任意

ページの開始位置。続行には返された nextOffset を使います。

≥ 0 · ≤ 9007199254740991 · 既定値 0

limitinteger任意

1 回の最大件数。このツールの範囲と既定値に従います。

≥ 1 · ≤ 5 · 既定値 5

引数の例 · JSON

{
  "agent": "shared",
  "scope": "global",
  "offset": 0,
  "limit": 5
}

結果と動作

各項目の current、update_available、unavailable、unmanaged と nextOffset を返します。続行時も同じ Agent と範囲を使います。

update_skill

アカウントが必要ローカルファイルを変更

パソコンにインストールされた Skillry 管理の Skill を、ユーザーが明示的に承認したバージョンに更新します。ローカルの編集を含む旧フォルダー全体をバックアップします。

引数5

agentstring必須

インストール先の Agent。MCP ホスト名とは別です。global は各 Skills フォルダー、project は shared または claude-code のみです。

scopestring任意

global は現在の OS ユーザー向け、project は明示した projectDirectory 配下へのインストールです。

global | project · 既定値 "global"

projectDirectorystring任意

プロジェクトの絶対パス。scope: project で必須、scope: global では指定不可。shared は .agents/skills、claude-code は .claude/skills を使います。

maxLength: 4096

slugstring必須

選んだ公開 Skill の正確な slug。小文字の kebab-case で最大 64 文字です。

minLength: 1 · maxLength: 64

expectedVersionstring必須

選んだ公開版。更新時は必須、インストール／ダウンロードでは任意です。公開版が変わったら再確認します。

minLength: 1 · maxLength: 64

引数の例 · JSON

{
  "slug": "<skill-slug>",
  "agent": "shared",
  "scope": "global",
  "expectedVersion": "<published-version>"
}

結果と動作

置換時はインストール版と backupPath を返します。すでに指定版なら置換しません。

インストール先

global：shared、codex、cursor、gemini-cli、opencode、kimi-code は ~/.agents/skills、claude-code は ~/.claude/skills、antigravity は ~/.gemini/config/skills。project は <projectDirectory>/.agents/skills または <projectDirectory>/.claude/skills。MCP の作業ディレクトリからプロジェクトを推測しないでください。

引数の例 · install_skill

{
  "slug": "<skill-slug>",
  "agent": "claude-code",
  "scope": "project",
  "projectDirectory": "/absolute/path/project",
  "expectedVersion": "<published-version>"
}

状態とトラブル対応

未認証または認証期限切れ: authentication_required／session_expired の場合、ユーザーに接続を確認して connect_account を呼び、URL とコードを示し、指定間隔で connection_status を確認します。承認後に元の操作を再試行します。
Skill フォルダーがすでにある: skill_already_installed の場合、同じ対象を list_installed_skills と check_updates で確認します。管理対象を選んだ新版へ更新する前に承認を求めます。MCP に force 引数はありません。
購入または日次上限への対応が必要: purchase_required／premium_required では purchaseUrl/actionUrl を案内し、daily_download_limit では resetsAt を示します。同日の同じ Skill の再ダウンロードは別枠を消費しません。日次上限は UTC 00:00 にリセットします。
Skillry のツールが表示されない: Node.js 22+、OS 設定、クライアントログを確認し、追加後に再起動または再読み込みします。現在の構成はブラウザーのみの環境や Linux を対象としていません。

呼び出す前に

クライアントに追加

アカウントと認証

検索と確認

引数9

結果と動作

引数1

結果と動作

アカウントと認証

結果と動作

結果と動作

結果と動作

結果と動作

引数1

結果と動作

ダウンロード・インストール・更新

引数3

結果と動作

引数5

結果と動作

引数3

結果と動作

引数5

結果と動作

引数5

結果と動作

インストール先

状態とトラブル対応

関連資料