box

Manage Box cloud files, sharing, search, metadata, and Box AI document workflows via the Box CLI.

1|Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Chia1104/agent-air --skill box-chia1104
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: box
Source: https://github.com/Chia1104/agent-air/tree/main/skills/hermes/productivity/box
Command: npx skills add https://github.com/Chia1104/agent-air --skill box-chia1104

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @box/cli, and includes references (resource) components.

What problem does it solve? Working with Box cloud storage from an AI agent requires correct OAuth setup, careful permission handling, and knowledge of dozens of CLI commands and API endpoints. This Skill gives Hermes a complete operational playbook for Box so file operations, collaboration, metadata extraction, and Box AI document Q&A happen safely and verifiably without the user memorizing commands. ## Core Features & Use Cases - File and folder operations: Upload, download, version, move, rename, share, and collaborate on Box content using ID-based CLI workflows with read-back verification. - Search, metadata, and Box AI: Run deterministic search and metadata queries, or use Box AI (ai:ask, ai:extract, ai:extract-structured, ai:text-gen) to summarize, classify, and extract structured fields from documents while keeping file bodies out of the model context. - Box Hubs and bulk work: Build curated Hub knowledge bases for Q&A over more than 25 files, and execute resumable bulk operations with inventory, confirmation, and recovery steps. - Use Case: Connect a Box account via OAuth, then ask the agent to extract invoice numbers and totals from a folder of PDFs and persist the results as Box metadata, verifying every write. ## Quick Start Ask the agent to connect your Box account with OAuth and then summarize the files in a specific Box folder.

Frequently Asked Questions about box

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect a Box account to an AI agent with OAuth?▼

Use the Box CLI OAuth flow: run `box login --default-box-app` on the same computer as your browser, or `box login --code` for a remote or headless host. After authorization, verify the actor with `box users:get me` before performing any operations.

How do I extract metadata from Box files using Box AI?▼

Use `box ai:extract-structured` with inline fields for a known schema, or `box ai:extract` for exploratory fields. Persist flat results to the built-in `global.properties` metadata instance or upload a JSON sidecar for nested data, then read the write back to verify it.

Can Box AI answer questions across many files at once?▼

Box AI Ask handles up to 25 files directly. For larger sets or a reusable knowledge base, use a Box Hub: discover an existing accessible Hub first, then send one `hubs` item to the `/ai/ask` endpoint with citations enabled.

Why does a shared Box file not appear in my root folder listing?▼

Folder `0` only lists the current actor's root and is not a complete access inventory. Fetch the known file or folder ID directly with `box files:get` or `box folders:get`, and use `box hubs --scope all` to discover Hubs, which are never listed as folders.

What should I do when the Box CLI lacks a command I need?▼

Use `box request` to call the matching REST endpoint with the CLI's configured OAuth identity, for example `box request /files/<ID> -X PUT --body '{"name":"new.pdf"}'`. This preserves authentication and does not require switching tools.

Can I create Box metadata templates through this workflow?▼

No. Box does not permit creating global templates, and enterprise template creation requires a Box Admin or Co-Admin. Store flat extraction results in `global.properties` or a JSON sidecar instead, and ask an administrator to create typed templates separately.