Skip to main content
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 Codex, Cursor, or Claude Code. 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.
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.
What to promptWhat 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.
What to promptWhat 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.
What to promptWhat 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.