> ## 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">
          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">
          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 = href;
  return <a href={localizedHref} className={className} {...props}>
      {children}
    </a>;
};

Agent Skills are pre-built instruction sets that teach AI coding assistants how to perform
specific tasks. Box Agent Skills give your AI assistant the context
it needs to build Box integrations, work with Box content via MCP tools, configure
webhooks, and use Box AI retrieval. No manual configuration is required.

The skills follow the [Agent Skills](https://agentskills.io/) open standard and
can be installed as a plugin for [Codex](https://openai.com/index/introducing-codex/),
[Cursor](https://cursor.com), or [Claude Code](https://code.claude.com).

For detailed reference material, additional examples, and contributing guidelines,
see the [box-for-ai repository](https://github.com/box/box-for-ai) on GitHub.

<SignupCTA>
  A free developer account gives you access to the Box AI API, Developer Console, and everything you need to start building AI-powered workflows.
</SignupCTA>

## Install

<Note>
  Running `npx skills add` prompts you to install the `skills` package if
  not already present. Confirm the installation when prompted to continue.
</Note>

<Tabs>
  <Tab title="Agent Skills">
    Run this in your project directory (or from any directory for a user-level
    install) to add all Box Agent Skills:

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

    To browse the full list of available skills, see the
    [Box skills registry](https://skills.sh/box/box-for-ai).
  </Tab>

  <Tab title="Codex plugin">
    Box Agent Skills can also be installed as a Codex plugin. See the
    [Codex setup guide](https://github.com/box/box-for-ai/blob/main/.codex-plugin/README.md)
    for configuration instructions, including how to connect the Box MCP server.
  </Tab>

  <Tab title="Cursor plugin">
    Box Agent Skills can also be installed as a Cursor plugin. See the
    [Cursor setup guide](https://github.com/box/box-for-ai/blob/main/.cursor-plugin/README.md)
    for configuration instructions, including how to connect the Box MCP server.
  </Tab>

  <Tab title="Claude Code plugin">
    For Claude Code, install Box Agent Skills as a platform plugin. See the
    [Claude Code setup guide](https://github.com/box/box-for-ai/blob/main/.claude-plugin/README.md)
    for configuration instructions.
  </Tab>
</Tabs>

<Tip>
  To verify that your Box account is connected after installation, run
  `box users:get me --json` in the <Link href="/guides/cli">Box CLI</Link>.
  A successful response confirms your authentication is working.
</Tip>

## Usage

Skills are loaded automatically when your assistant detects a relevant task.
Ask your assistant to perform Box-related tasks in natural language and it will
select the appropriate skill.

<AccordionGroup>
  <Accordion title="Add file uploads, shared links, and webhooks">
    | What to prompt                            | What happens                                         |
    | ----------------------------------------- | ---------------------------------------------------- |
    | "Add Box file upload to my app"           | Scaffolds file upload integration using the Box SDK. |
    | "Create a shared link for this folder"    | Generates code to create and configure shared links. |
    | "Set up Box webhooks for new file events" | Sets up webhook listeners for file creation events.  |
  </Accordion>

  <Accordion title="Search, classify, and process documents">
    | What to prompt                         | What happens                                            |
    | -------------------------------------- | ------------------------------------------------------- |
    | "Search my Box account for invoices"   | Uses the Box Search API to find matching files.         |
    | "Use Box AI to classify documents"     | Implements document classification with the Box AI API. |
    | "Wire webhooks to process new uploads" | Connects webhook events to document processing logic.   |
  </Accordion>

  <Accordion title="Automate multi-step file processing">
    | What to prompt                                                                                 | What happens                                                                                                |
    | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
    | "Extract invoice numbers and totals from these PDFs, and put them in a table"                  | Locates the PDFs, runs Box AI extraction on each, and formats results into a structured table.              |
    | "Organize the files in this folder by type. Classify with Box AI and move into subfolders"     | Inventories the folder, classifies files using Box AI, creates target subfolders, and moves files serially. |
    | "Build a search-first retrieval flow for invoice lookup that only downloads files when needed" | Searches Box with filters first, then retrieves content only for the matching shortlist.                    |
  </Accordion>

  <Accordion title="Troubleshoot integrations">
    | What to prompt                          | What happens                                      |
    | --------------------------------------- | ------------------------------------------------- |
    | "Debug 401 errors with my Box JWT auth" | Walks through JWT authentication troubleshooting. |
    | "Fix webhook signature verification"    | Diagnoses and resolves webhook signature issues.  |
  </Accordion>
</AccordionGroup>

## Skill structure

Box Agent Skills follow the [Agent Skills open standard](https://agentskills.io/).
Each skill is a directory containing instruction files and supporting resources.

```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>
  Skills are concise by design. They use tables instead of prose and focus on the
  information an AI assistant needs to generate accurate code.
</Tip>