Box Cloud Filesystem

What it does

When your agent uses it

• The user mentions Box
• Uploading to the cloud
• Document management
• Syncing project files offsite

Example prompts

• “upload to box”
• “save to cloud”
• “pull from box”
• “/box-cloud-filesystem”

Requirements

• Node.js
• Compatibility (from SKILL.md): Designed for Claude Code, also compatible with Codex and OpenClaw
• Pre-approved tools (allowed-tools): Read, Write, Edit, Bash(box:*), Bash(npm:*), Bash(npx:*), Glob, Grep

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1Classify the intent — discover, read, upload, update, organize, sync, share, or cleanup
2. 2Orient — run box users:get --me, identify target folder ID, check the trust zone
3. 3Discover — list or search Box to understand what exists before modifying anything
4. 4Execute — perform the operation (see references/operations-guide.md for commands)
5. 5Report — return file IDs, folder IDs, action types, and any conflicts

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Write
  • Edit
  • Bash(box:*)
  • Bash(npm:*)
  • Bash(npx:*)
  • Glob
  • Grep

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • npm

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • developer.box.com
  • github.com
  • box.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Designed for Claude Code, also compatible with Codex and OpenClaw

  From compatibility in the SKILL.md frontmatter.

Context cost

Box Cloud Filesystem loads about 1.8k tokens when it runs, and up to ~4.3k if it reads all its reference files. Until then it costs about 93 tokens; SKILL.md has 622 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~93

When it runs · the whole SKILL.md, loaded when a task matches

~1.8k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~4.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 622 words, ~1,765 tokens.

name

box-cloud-filesystem

description

Cloud filesystem operations via Box CLI. Use when the user mentions Box, cloud files, cloud storage, uploading to the cloud, sharing files, document management, or syncing project files offsite. Trigger with "upload to box", "save to cloud", "pull from box", "search my box files", "share this file", "box sync", "cloud backup", or "box filesystem".

allowed-tools

Read, Write, Edit, Bash(box:*), Bash(npm:*), Bash(npx:*), Glob, Grep

compatibility

Designed for Claude Code, also compatible with Codex and OpenClaw

version

1.0.0

author

Jeremy Longshore <jeremy@intentsolutions.io>

license

MIT

tags

box, cloud-storage, filesystem, sync, collaboration, document-management

npm install --global @box/cli
box login
box users:get --me   # verify auth + enterprise context

box folders:items FOLDER_ID --json                    # list folder
box search "query" --type file --json                  # search
box files:download FILE_ID --destination ./             # download
box files:upload ./file.txt --parent-id FOLDER_ID       # upload new
box files:versions:upload FILE_ID ./file.txt            # update existing
box files:share FILE_ID --access collaborators          # share (narrow)
box folders:download FOLDER_ID --destination ./         # bulk download

${CLAUDE_PLUGIN_ROOT}/scripts/box-init-workspace.sh FOLDER_ID /tmp/box-workspace

box folders:create 0 "my-project-docs" --json
box files:upload docs/README.md --parent-id FOLDER_ID
box folders:share FOLDER_ID --access collaborators

box search "Q1 sales" --type file --json
box files:download FILE_ID --destination /tmp/box-workspace/
# analyze locally, then push result
box files:upload /tmp/box-workspace/summary.md --parent-id PARENT_ID

${CLAUDE_PLUGIN_ROOT}/scripts/box-init-workspace.sh FOLDER_ID /tmp/box-workspace
# edit files normally — hooks auto-sync to Box

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in plugins/productivity/box-cloud-filesystem/skills/box-cloud-filesystem of jeremylongshore/tons-of-skills-marketplace.

• SKILL.md
• references/operations-guide.md
• references/sync-pattern.md

Open the folder on GitHubat commit cfae287