Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Integracja z narzędziem

box-cloud-filesystem

/box-cloud-filesystem

Zarządza plikami w Box przez oficjalne Box CLI: wyszukuje, pobiera, wgrywa, aktualizuje wersje, udostępnia i synchronizuje zawartość z potwierdzeniami operacji.

Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Zarządza plikami w Box przez oficjalne Box CLI: wyszukuje, pobiera, wgrywa, aktualizuje wersje, udostępnia i synchronizuje zawartość z potwierdzeniami operacji.

Wyzwalacze z opisu

upload to Boxsearch Boxshare this Box file

Argumenty

/box-cloud-filesystem [search|download|upload|update|share|sync] [target]
Oryginalny opis (EN)

Manage Box files with the official Box CLI using reviewed, receipt-backed reads, uploads, version updates, and sharing. Use when a user asks to search, download, upload, update, organize, share, or synchronize Box content, and trigger with "upload to Box", "search Box", "share this Box file", or "review my Box sync queue.

Jak działa

  1. Overview
  2. Prerequisites
  3. Workflow
  4. Trust zones
  5. Current command surface
  6. Reviewed workspace queue
  7. Output
  8. Error Handling
  9. Examples
  10. Resources
Sekcje z nagłówków SKILL.md, w oryginale · 140 linii, 764 słów
Podgląd SKILL.md
---
name: box-cloud-filesystem
description: |
  Manage Box files with the official Box CLI using reviewed, receipt-backed
  reads, uploads, version updates, and sharing. Use when a user asks to search,
  download, upload, update, organize, share, or synchronize Box content,
  and trigger with "upload to Box", "search Box", "share this Box file", or
  "review my Box sync queue."
allowed-tools: "Read,Write,Edit,Glob,Grep,Bash(box:*)"
argument-hint: "[search|download|upload|update|share|sync] [target]"
version: "2.0.0"
author: "Jeremy Longshore <jeremy@intentsolutions.io>"
license: "MIT"
compatibility: "Explicit operations require Node.js 18+, Box CLI 4.x, Box authentication, and network access. Claude Code workspace queue hooks additionally require Bash and jq. Other Agent Skills hosts can use explicit Box CLI mode."
tags: [box, cloud-storage, filesystem, sync, collaboration, document-management]
model: inherit
effort: medium
---

# Box Cloud Filesystem

## Overview

Operate Box through numeric file and folder IDs, narrow sharing defaults, and
verified receipts. The plugin's Write/Edit hook only queues local workspace
changes for review and never uploads automatically; see the
[reviewed sync pattern](references/sync-pattern.md) for the complete flow.

## Prerequisites

```bash
box version
box users:get me --json
```

- Install the current supported Box CLI 4.x through an operator-approved Node
  package workflow; do not install packages automatically.
- Use `box login` for interactive OAuth. JWT and CCG require a Box Platform App,
  appropriate scopes, secure configuration, and enterprise admin authorization.
- Never request or pass access tokens through chat or the CLI `--token` flag.
- The bundled workspace scripts require Bash and `jq`.

## Workflow

1. Classify the request as discover, read, create, update, expose, synchronize,
   or destructive.
2. Verify the active Box identity with `box users:get me --json` and report the
   account or enterprise without exposing credentials.
3. Discover the target by listing or searching. Use `Read`, `Glob`, and `Grep`
   only for the local files the user placed in scope.
4. Resolve every remote target to a numeric Box ID. Names are not unique.
5. Preview the operation:
   - uploads: local path, size, parent folder ID, and collision result;
   - updates: file ID, local path, and remote `content_modified_at`;
   - sharing: target ID, access level, download/edit flags, and expiry;
   - deletion or bulk moves: every target and recoverability.
6. Execute only the operation the user authorized. Ask before public/open links,
   deletes, bulk reorganizations, overwriting remote changes, or widening app
   access. Use `Write` or `Edit` only for requested local artifacts.
7. Re-read the affected Box item and return the receipt contract below.

## Trust zones

| Zone | Examples | Boundary |
|---|---|---|
| Read | search, list, metadata, download | Stay within the requested account/folder scope |
| Create | upload, create folder | Verify parent ID and name collision |
| Update | version upload, move, copy | Verify file ID and remote modification time |
| Expose | shared link, collaborator access | Confirm audience and access settings |
| Destructive | delete, bulk move | Explicit request plus target summary |

Never use `--yes` to suppress a Box CLI confirmation for expose or destructive
operations.

## Current command surface

```bash
box folders:items FOLDER_ID --json --fields name,id,type,content_modified_at
box search "query" --type file --json
box files:get FILE_ID --json --fields name,size,content_modified_at,shared_link
box files:download FILE_ID --destination LOCAL_PATH
box files:upload LOCAL_PATH --parent-id FOLDER_ID --json
box files:versions:upload FILE_ID LOCAL_PATH --json
box files:share FILE_ID --access collaborators --json
```

Use `box COMMAND --help` as command truth. The
[operations guide](references/operations-guide.md) covers moves, folders,
sharing, and recovery.

## Reviewed workspace queue

Initialize only when the user explicitly selects a Box folder and local path:

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

Initialization performs a Box read, downloads the folder, and stores a
permission-restricted local config. Subsequent Write/Edit hooks add eligible
relative paths to `.box-sync-pending`; hidden files and credential-like names are
excluded. The Stop hook reports the queue and performs no upload.

Before syncing, list each remote item again, compare modification timestamps,
show create/update/conflict groups, and obtain approval. Upload changed known
files with `files:versions:upload`; upload genuinely new files with
`files:upload`. Never infer a remote deletion from a missing local file.

## Output

Return:

- Box account context and target folder ID;
- operation and local/remote target;
- created or updated file/folder ID;
- sharing access, expiry, and URL when applicable;
- preflight comparison and any conflict;
- command exit result plus post-operation metadata;
- queued/skipped paths and the reason.

## Error Handling

- **401/expired auth:** run `box login`; never ask for a token in chat.
- **403:** report the missing scope or collaboration/admin boundary; do not widen
  access automatically.
- **404:** verify identity and ID by re-listing the parent.
- **409/name collision:** choose a version upload or an explicitly distinct name.
- **429:** honor retry guidance and reduce/batch read operations; do not loop
  indefinitely.
- **Remote changed since download:** stop and ask whether to keep remote, local,
  or both.
- **Partial bulk failure:** re-list the target, report confirmed successes, and
  retry only unresolved items after approval.
- **Hook queue failure:** preserve local work; report that no Box upload occurred.

## Examples

Update an existing file without creating a duplicate:

```bash
box files:get FILE_ID --json --fields name,content_modified_at
box files:versions:upload FILE_ID approved-report.md --json
box files:get FILE_ID --json --fields name,version_number,content_modified_at
```

Create a collaborators-only link after confirming the audience:

```bash
box files:share FILE_ID --access collaborators --json
```

## Resources

- [Box CLI operations and recovery](references/operations-guide.md)
- [Reviewed workspace synchronization](references/sync-pattern.md)
- [Box CLI source and generated command docs](https://github.com/box/boxcli)
- [Box security model](https://developer.box.com/guides/security/)
Pliki w paczce (3)
  • SKILL.md 6 KB
  • references/operations-guide.md 6 KB
  • references/sync-pattern.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie box-cloud-filesystem.

Migawka bazy z 13.11.2026 · wersja paczki 95317f9ceac1 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100box-cli
    Wykonuje operacje w Box przez oficjalne Box CLI, w tym skrypty powłoki, uwierzytelnianie, diagnostykę i zbiorcze zadania na plikach.
  • 95box
    Buduje integracje z Box: wysyłanie i pobieranie plików, udostępnianie, wyszukiwanie, metadane i automatyzacje z Box AI.
  • 100box
    Obsługuje pliki, foldery i dyski w Box przez ujednolicone API File Storage Apideck, z przełączaniem konektorów zmianą serviceId.
  • 100box
    Obsługuje podstawy pracy z Box: uwierzytelnianie, konfiguracja MCP i CLI, wybór między MCP, CLI i REST, limity zapytań, diagnoza błędów 401, 403, 404, 409 i 429 oraz narzędzia MCP Box.
  • 90weiyun-management
    Zarządza chmurą Tencent Weiyun przez zestaw narzędzi w Pythonie z CLI i SDK: wysyłanie i pobieranie plików, udostępnianie, przestrzeń oraz logowanie kodem QR lub ciasteczkami.
  • 100library
    Obsługuje bibliotekę ChatGPT: wyszukuje i czyta pliki i strony w bibliotece, porządkuje foldery, przywraca poprzednie wersje, udostępnia pliki i foldery oraz tworzy lub aktualizuje artefakty dla użytkownika.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.