box

Manage Box cloud files, sharing, search, metadata, and Box AI extraction via CLI.

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill box-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: box
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/productivity/box
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill box-tylersimons1127

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 juggling OAuth authentication, CLI conventions, metadata schemas, and Box AI operations; this Skill provides a complete operational playbook so Hermes can perform Box file, collaboration, search, and document-intelligence tasks safely and verifiably. ## Core Features & Use Cases - File and Folder Operations: Upload, download, version, move, rename, share, and collaborate on Box content using the Box CLI with ID-based, verified workflows. - 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 without downloading file bodies. - 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 verification steps. - Use Case: Ask the agent to extract invoice numbers, vendors, and totals from a folder of Box-hosted invoices and persist the results as global.properties metadata or JSON sidecars, with every write read back and verified. ## Quick Start Connect my Box account with OAuth and summarize the renewal terms in the contracts folder, citing each source file.

Frequently Asked Questions about box

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

FAQPage Schema
How do I connect the Box CLI to my Box account with OAuth?▼

Run `box login --default-box-app --name <ENV>` for a same-computer browser flow, or add `--code` when Hermes runs on a remote or headless host. After the browser authorization completes, verify the actor with `box users:get me --json` before doing any work.

How do I extract metadata from files stored in Box?▼

Use `box ai:extract-structured` with inline `--fields` for known schemas 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.

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

Box AI Ask handles up to 25 selected files directly. For larger or recurring Q&A, use a Box Hub: discover an existing accessible Hub first, get approval before creating one, and query it through the `/ai/ask` endpoint with a `hubs` item type.

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. Verify the actor with `box users:get me`, then fetch the known file or folder ID directly with `box files:get` or `box folders:get`.

What are the limitations of Box metadata templates?▼

Box does not permit creating templates in the `global` scope, and enterprise templates require a Box Admin or authorized Co-Admin. The `global.properties` instance accepts schema-free values but cannot be queried with the Metadata Query API.

When should I use the Box SDK instead of the Box CLI?▼

Use the CLI for one-off agent tasks and content operations. Use an official Box SDK, such as box-python-sdk-gen or the `box` npm package, when building a shipped application that needs OAuth clients, webhooks, or bounded concurrency with explicit retry handling.