> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Box Agent Skills

export const SignupCTA = ({children}) => {
  return <div className="flex flex-wrap items-center gap-4 p-5 rounded-lg border border-gray-200 dark:border-gray-700 my-6" style={{
    background: "linear-gradient(135deg, rgba(0, 97, 213, 0.06), rgba(0, 97, 213, 0.02))"
  }}>
      <div className="flex-1 text-sm leading-relaxed text-gray-700 dark:text-gray-300" style={{
    minWidth: "280px"
  }}>
        {children}
      </div>
      <div className="flex flex-col items-center gap-2">
        <a href="https://account.box.com/signup/developer#ty9l3" className="signup-cta-button inline-flex items-center whitespace-nowrap px-5 py-2 text-sm font-semibold text-white no-underline">
          {translate("Get started for free")}
        </a>
        <a href="https://account.box.com/developers/console" className="signup-cta-login text-xs text-gray-500 dark:text-gray-400 no-underline whitespace-nowrap">
          {translate("Already have an account? Log in")}
        </a>
      </div>
    </div>;
};

export const RelatedLinks = ({title, items = []}) => {
  const getBadgeClass = badge => {
    if (!badge) return "badge-default";
    const badgeType = badge.toLowerCase().replace(/\s+/g, "-");
    return `badge-${badge === "ガイド" ? "guide" : badgeType}`;
  };
  if (!items || items.length === 0) {
    return null;
  }
  return <div className="my-8">
      {}
      <h3 className="text-sm font-bold uppercase tracking-wider mb-4">{title}</h3>

      {}
      <div className="flex flex-col gap-3">
        {items.map((item, index) => <a key={index} href={item.href} className="py-2 px-3 rounded related_link hover:bg-[#f2f2f2] dark:hover:bg-[#111827] flex items-center gap-3 group no-underline hover:no-underline border-b-0">
            {}
            <span className={`px-2 py-1 rounded-full text-xs font-semibold uppercase tracking-wide flex-shrink-0 ${getBadgeClass(item.badge)}`}>
              {item.badge}
            </span>

            {}
            <span className="text-base">{item.label}</span>
          </a>)}
      </div>
    </div>;
};

export const Link = ({href, children, className, ...props}) => {
  const localizedHref = localizeLink(href);
  return <a href={localizedHref} className={className} {...props}>
      {children}
    </a>;
};

Agent Skillsは、AIコーディングアシスタントに特定のタスクの実行方法を学習させる、あらかじめ作成された指示セットです。これにより、AIアシスタントには、Box統合の作成、MCPツールを通じたBoxコンテンツの操作、Webhookの構成、Box AI検索の利用に必要なコンテキストが提供されます。手動による構成は必要ありません。

スキルは、[Agent Skills](https://agentskills.io/)のオープンスタンダードに準拠しており、[Codex](https://openai.com/index/introducing-codex/)、[Cursor](https://cursor.com)、または[Claude Code](https://code.claude.com)のプラグインとしてインストールできます。

詳細な参考資料、追加の例、投稿ガイドラインについては、GitHubの[box-for-aiリポジトリ](https://github.com/box/box-for-ai)を参照してください。

<SignupCTA>
  無料のDeveloperアカウントを作成すると、Box AI APIや開発者コンソールなど、AIを活用したワークフローの構築を開始するために必要なすべての機能にアクセスできます。
</SignupCTA>

## インストール

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

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

    ```bash theme={null}
    npx skills add box/box-for-ai
    ```

    使用可能なスキルの全一覧を確認するには、[Boxのスキルレジストリ](https://skills.sh/box/box-for-ai)を参照してください。
  </Tab>

  <Tab title="Codexプラグイン">
    Box Agent Skillsは、Codexプラグインとしてインストールすることもできます。Box MCPサーバーへの接続方法など、構成手順については[Codex設定ガイド](https://github.com/box/box-for-ai/blob/main/.codex-plugin/README.md)を参照してください。
  </Tab>

  <Tab title="Cursorプラグイン">
    Box Agent Skillsは、Cursorプラグインとしてインストールすることもできます。Box MCPサーバーへの接続方法など、構成手順については[Cursor設定ガイド](https://github.com/box/box-for-ai/blob/main/.cursor-plugin/README.md)を参照してください。
  </Tab>

  <Tab title="Claude Codeプラグイン">
    Claude Codeを使用する場合は、Box Agent Skillsをプラットフォームプラグインとしてインストールします。構成手順については、[Claude Code設定ガイド](https://github.com/box/box-for-ai/blob/main/.claude-plugin/README.md)を参照してください。
  </Tab>
</Tabs>

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

## 使用方法

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

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

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

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

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

## スキル構造

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

```text theme={null}
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
```

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