Box Agent Skills - Box Dev Docs

Agent Skillsは、AIコーディングアシスタントに特定のタスクの実行方法を学習させる、あらかじめ作成された指示セットです。これにより、AIアシスタントには、Box統合の作成、MCPツールを通じたBoxコンテンツの操作、Webhookの構成、Box AI検索の利用に必要なコンテキストが提供されます。手動による構成は必要ありません。スキルは、Agent Skillsのオープンスタンダードに準拠しており、Codex、Cursor、またはClaude Codeのプラグインとしてインストールできます。詳細な参考資料、追加の例、投稿ガイドラインについては、GitHubのbox-for-aiリポジトリを参照してください。

インストール

npx skills addを実行すると、skillsパッケージがまだない場合に、このパッケージをインストールするよう求められます。続行を促すプロンプトが表示されたら、インストールを確認してください。

Agent Skills
Codexプラグイン
Cursorプラグイン
Claude Codeプラグイン

次のコマンドをプロジェクトディレクトリ (または、ユーザーレベルのインストールに使用する任意のディレクトリ) で実行して、すべてのBox Agent Skillsを追加します。

npx skills add box/box-for-ai

使用可能なスキルの全一覧を確認するには、Boxのスキルレジストリを参照してください。

インストール後に自分のBoxアカウントが接続されていることを確認するには、でbox users:get me --jsonを実行します。成功のレスポンスが返される場合は、認証が確実に機能しています。

使用方法

スキルは、アシスタントが関連するタスクを検出したときに自動的に読み込まれます。Box関連のタスクを実行するように自然言語で指示すると、アシスタントは適切なスキルを選択します。

ファイルアップロード、共有リンク、Webhookの追加

プロンプト	実行内容
「Boxファイルアップロードをアプリに追加してください」	Box SDKを使用してファイルアップロード統合をスキャフォールディングします。
「このフォルダの共有リンクを作成してください」	共有リンクを作成して構成するコードを生成します。
「新しいファイルイベントに対してBoxのWebhookを設定してください」	ファイル作成イベントに対してWebhookリスナーを設定します。

ドキュメントの検索、分類、処理

プロンプト	実行内容
「私のBoxアカウントにある請求書を検索してください」	Box検索APIを使用して、一致するファイルを見つけます。
「Box AIを使用してドキュメントを分類してください」	Box AI APIを使用してドキュメント分類を実装します。
「新しいアップロードを処理するWebhookを実装してください」	Webhookイベントをドキュメント処理ロジックに接続します。

マルチステップのファイル処理の自動化

プロンプト	実行内容
「これらのPDFから請求書の番号と合計金額を抽出して表に入力してください」	PDFを特定し、各ファイルでBox AI抽出を実行して、抽出結果を構造化された表の形式に整えます。
「このフォルダ内のファイルを種類に基づいて整理してください。Box AIで分類を行い、サブフォルダに移動させてください」	フォルダ内のファイルの一覧を作成し、Box AIでファイルを分類します。さらに、ターゲットサブフォルダを作成し、ファイルを順次移動させます。
「請求書検索用に、必要な場合にのみファイルをダウンロードする検索優先取得フローを構築してください」	まずフィルタでBoxを検索し、その後、一致した候補リストについてのみコンテンツを取得します。

統合のトラブルシューティング

プロンプト	実行内容
「Box JWT認証の401エラーをデバッグしてください」	JWT認証のトラブルシューティング手順を説明します。
「Webhook署名の検証を修正してください」	Webhook署名に関する問題を診断して解決します。

スキル構造

Box Agent Skillsは、Agent Skillsのオープンスタンダードに準拠しています。各スキルは、指示ファイルとサポートリソースが含まれているディレクトリです。

box/
  SKILL.md          # Skill manifest with frontmatter,routing table, workflow steps, and guardrails
  references/       # Feature-specific deep dives (auth, content workflows, MCP, AI/retrieval, etc.)
  examples/         # Example prompts

スキルは簡潔に設計されています。スキルでは、文ではなく表が使用され、AIアシスタントが正確なコードを生成するために必要な情報に焦点が当てられます。

​インストール

​使用方法

​スキル構造

インストール

使用方法

スキル構造