BOX

Verify the connected Box MCP server. Confirms whether the user is on Box's official remote MCP at mcp.box.com (recommended; required for Box AI tools) or a community/deprecated Box MCP. Reports OAuth scopes granted and tool coverage. Surfaces harness-specific setup steps (Hermes, OpenClaw, Codex, Cursor, custom) when Box OAuth needs manual configuration. Use when setting up box-memory for the first time, when AI tools fail with tool-not-found errors, when OAuth fails with 401 or no-auth symptoms, or when the user asks which Box MCP they are using.

Create, update, or invoke a persistent Box AI Studio agent for memory recall. The "memory librarian" agent has locked instructions ("answer only from the indexed workspace, cite file IDs, never speculate"). Enterprise Advanced only. Use when the user wants a fixed-behavior AI assistant over their memory workspace, with locked guardrails instead of ad-hoc prompts.

Extract structured metadata from a binary file in Box using Box AI Extract Structured. Replaces "couldn't parse this format" stubs in companions with OCR + schema-driven extraction for PDFs / TIFF / PNG / JPEG. Returns extracted fields with confidence scores and source-text citations. Use during companion generation or when the user explicitly wants metadata extracted from a file.

Semantic Q&A over box-memory contents using Box AI. Wraps the Box AI /ai/ask endpoint - multi-doc Q&A across up to 25 files (Business+) or Hub-indexed Q&A across up to 20,000 files (Enterprise Plus). Returns answers with citations. Use when the user asks an open-ended question, box-recall returns sparse results, or when the user wants fuzzy semantic search instead of exact match.

Generate a paired companion markdown file for a binary in Box. The companion describes what the file is - summary, key facts, classification, related memories - pinned to a specific version via SHA256 hash. This is the no-chunking, no-embedding alternative to RAG. Use when the user uploads a binary and asks to remember what it is, describe a file, make a companion, or review a PDF/CAD/Office document.

Bootstrap a Box.com workspace for agent memory and file storage. Creates folder structure (or a Box Hub on Enterprise Plus), writes workspace config, detects tier and capabilities, defines the boxMemory metadata template (Business+) so Box AI Extract can target it. Use when the user wants to set up box-memory, initialize a workspace, or create a Box vault for the first time.

Find memories in a box-memory workspace by ID, wikilink, slug, structured filters, or free-text. Bypasses Box's 10-minute search indexing lag by reading the per-folder index files. Use when the user asks "what do I know about X", "what did we decide", "find memories tagged Y", "recall", or "search my Box memory".

Add or manage a team subtree in a box-memory workspace. Creates team folders with their own memories, files, and index - and tracks teams in workspace config. Box folder ACLs are the real isolation boundary; this skill creates structure only. Use when the user wants to create a team, list teams, inspect a team's contents, find cross-team conflicts, or remove a team.

Probe a Box account to detect its tier (Personal, Business, Enterprise, Enterprise Plus) and capability matrix - custom metadata templates, body search, max file size, retention, legal holds. Mostly invoked internally by other skills; can also be called directly when the user asks what tier their Box account is on or what features it supports.

Rebuild a folder's _index.json (or the workspace-root rollup) from scratch by listing the folder and re-reading every memory's frontmatter. Also detects stale file companions whose hash no longer matches the binary. Use when an index is suspected stale, drifted, corrupted, or after a bulk Box-side change like manual file upload, deletion, or version replace.

Report the box-memory workspace status - tier, capabilities, teams, memory counts, index health, recent activity. Read-only. Use when the user asks what's in their Box workspace, wants to show workspace status, asks how many memories or what tier, or wants a sanity check before a heavy operation.

Save a memory to Box as a durable markdown file with YAML frontmatter and Obsidian-style wikilinks. Append-only, never overwrites. Use when the user says "remember that...", "save this", "log a decision", "record an observation", or anything that should persist as agent memory across sessions.