Box Agent Skills - Box Dev Docs

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 open standard and can be installed as a plugin for ChatGPT/Codex, Cursor, or Claude/Claude Code. To get access to the full plugin with all the skills, ensure that you are logged in to the selected AI tool. For detailed reference material, additional examples, and contributing guidelines, see the box-for-ai repository on GitHub.

Install

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

Agent Skills
Codex plugin
Cursor plugin
Claude Code plugin

Run this in your project directory (or from any directory for a user-level install) to add all Box Agent Skills:

npx skills add box/box-for-ai

To browse the full list of available skills, see the Box skills registry.

To verify that your Box account is connected after installation, run box users:get me --json in the . A successful response confirms your authentication is working.

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.

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.

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.

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.

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.

Skill structure

Box Agent Skills follow the Agent Skills open standard. Each skill is a directory containing instruction files and supporting resources.

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

Skills are concise by design. They use tables instead of prose and focus on the information an AI assistant needs to generate accurate code.

​Install

​Usage

​Skill structure

Install

Usage

Skill structure