Box Agent Skills - Box Dev Docs

Box Agent Skills are task-specific instructions for AI assistants working with Box. They can help an assistant build Box integrations, use Box content through connected tools, and carry out document workflows. The skills follow the Agent Skills format and can be installed individually or through a supported platform plugin. The box/skills repository is the source of truth for the current skill list, what each skill does, its dependencies, and platform installation notes. Start with its README to choose a skill for your task.

Skills provide instructions. Installing them does not authorize your assistant to access Box. Set up a Box connection separately for tasks that need live content or API calls.

Install

Running npx skills add may prompt you to install the skills package. Confirm the installation to continue.

Agent Skills
Codex plugin
Cursor plugin
Claude Code plugin
Kiro Power

With Node.js and npm installed, choose Box skills interactively:

npx skills add box/skills

Run the command in your project directory. See the repository README for the current skills, individual installation options, and dependencies.

In Kiro’s Powers panel, install Box from the catalog. If it is not listed, select Add Custom Power → Import power from GitHub and enter https://github.com/box/skills. See the repository’s Kiro notes.

Connect to Box

Choose the connection that matches your task:

Box MCP: Configure and authorize the hosted Box MCP server in your AI client. Follow the supported-platform guides.
Box CLI: Install and authenticate the Box CLI for command-line work.
Application code: Use your application’s existing Box authentication and the appropriate SDK or API setup.

The Box MCP endpoint is https://mcp.box.com, but the client handles its authentication. Keep credentials in your client or application’s settings, outside the skills repository. Available operations depend on the connected user’s permissions, app scopes, admin settings, and product entitlements. Verify the connection you plan to use. For MCP, ask the assistant to discover the available Box tools and call who_am_i to confirm the acting user. For the CLI, run box users:get me --json. For application code, make a small read request through the configured client. A successful check with one connection does not verify another.

Ask your assistant

Once the relevant skill and connection are available, describe the outcome you want. Your assistant can select an installed skill from its description, or you can name one explicitly. These prompts illustrate the types of work covered by the current repository; replace folder references and review criteria with your own.

Connect to Box and work with content

What to prompt	How the skills help
”Connect this assistant to Box through the hosted MCP server.”	Guides client setup, tool discovery, and verification of the acting Box user.
”Find invoices in this Box folder using my connection.”	Selects an available Box tool, searches the requested scope, and checks the results.
”Help me diagnose a 403 error when accessing this folder.”	Checks the acting identity, permissions, and relevant authentication setup.

Use the Box CLI for repeatable operations

What to prompt	How the skills help
”Use the Box CLI to list the first 20 items in this folder as JSON.”	Uses installed CLI help to choose command syntax and verify the result.
”Plan a resumable bulk metadata update with the Box CLI.”	Guides batching, progress tracking, retries, and rate-limit handling.

Build and troubleshoot Box integrations

What to prompt	How the skills help
”Add Box file upload to this app using its existing authentication setup.”	Guides implementation with an appropriate Box SDK and version-specific methods.
”Fix webhook signature verification and duplicate event handling.”	Guides debugging and tests for invalid signatures and repeated deliveries.
”Review this Box sync worker for redundant API calls and 429 handling.”	Identifies efficiency and retry issues in a repeatable integration.

Run legal document workflows

What to prompt	How the skills help
”Check this intake folder against our required-document checklist.”	Identifies missing submissions and prepares a summary for attorney review.
”Compare this NDA with our approved template.”	Produces a cited variance report for attorney review.
”Set up an M&A data room using our folder plan and access matrix.”	Guides folder structure, scoped access, and permission checks.

​Install

​Connect to Box

​Ask your assistant

Install

Connect to Box

Ask your assistant