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

dbxcli

/dbxcli

Bezpiecznie obsługuje Dropbox przez lokalne narzędzie dbxcli: pliki, linki udostępniania, zespoły i konta.

Repozytorium
dbxcli ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
28.09.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
5
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

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

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Bezpiecznie obsługuje Dropbox przez lokalne narzędzie dbxcli: pliki, linki udostępniania, zespoły i konta.

Oryginalny opis (EN)

Safely operate Dropbox through a locally installed dbxcli command, using its JSON manifest and schema-backed machine contract. Use for Dropbox file, shared-link, team, or account work; do not call the Dropbox API directly.

Jak działa

  1. Start safely
  2. Execution contract
  3. Large listings, search, and multi-step work
  4. Boundaries
Sekcje z nagłówków SKILL.md, w oryginale · 89 linii, 690 słów
Podgląd SKILL.md
---
name: dbxcli
description: Safely operate Dropbox through a locally installed dbxcli command, using its JSON manifest and schema-backed machine contract. Use for Dropbox file, shared-link, team, or account work; do not call the Dropbox API directly.
---

# dbxcli

Use the local `dbxcli` executable as the only Dropbox integration. Do not
reimplement Dropbox API calls, scrape text help, or maintain a command catalog
in this skill. The CLI's JSON help manifest is authoritative for the installed
version.

## Start safely

1. Check availability with `command -v dbxcli`, then run
   `dbxcli version --output=json`. If it is unavailable, say so and give
   installation guidance for the user's operating system, using the
   [dbxcli releases](https://github.com/dropbox/dbxcli/releases) page. Do not
   download or install it unless the user authorizes that action.
2. Before a command you have not already discovered in the current task, run
   `dbxcli [command path] --help --output=json`. Begin with
   `dbxcli --help --output=json` when the command path is unknown.
3. Read the manifest's `supports_structured_output`, `input_schema`,
   `stdin_stdout`, `destructive_level`, `flags`, and `args`. Do not infer a
   command or flag from memory.
4. Represent the intended arguments and flags as JSON-shaped input and validate
   it against that command's `input_schema` before building the shell command.
   Map fields to command-line names using each field's `x-cli-name`.

Read [tool-integration.md](references/tool-integration.md) for the discovery,
validation, result, and error protocol. Read [automation.md](references/automation.md)
for writes and confirmation behavior. Read [safety.md](references/safety.md)
before handling credentials, transfers, deletion, replacement, or sharing.

## Execution contract

For normal command execution, always pass `--output=json` and parse stdout as a
single JSON envelope. Treat stderr as diagnostics only. Check both the process
exit code and `.ok`:

- If `.ok` is `true`, use documented `results[].status`, `results[].kind`, and
  `warnings`; do not rely on prose or undocumented fields.
- If `.ok` is `false`, branch on stable `.error.code`, not `.error.message`.
  Surface a concise, redacted explanation and use structured `.error.details`
  only when relevant. Do not blindly retry writes or auth errors.
- If the manifest says `supports_structured_output: false`, do not run that
  command as a machine-action. Explain the limitation or use a safe supported
  alternative. JSON help itself remains available.

For destructive or externally visible actions, first discover the command and
validate inputs, then prefer `--dry-run` if the manifest exposes it. Use an
explicit `--if-exists` policy whenever it is available; never assume that a
default overwrite or conflict policy matches the user's intent. A successful
dry-run does not authorize execution; obtain explicit user confirmation before
the real destructive action. When a command exposes `--yes`, use it only after
that confirmation to prevent an interactive prompt from blocking automation.

## Large listings, search, and multi-step work

The CLI follows Dropbox pagination internally; agents must not invent or pass
cursors. For a broad `ls` or `search`, discover the command and use its
`--limit` flag to bound the result delivered to the tool. Start with the
narrowest sensible folder or search path; do not recursively enumerate a whole
Dropbox when a scoped query will answer the request. A limited result is a
selection, not proof that no additional matches exist.

For search requests about text *inside* files, inspect the `search` manifest
and pass `--content` only when it is available and the user requested a
content search. Otherwise search is filename-oriented. Scope the search path
and limit whenever practical.

For a search → get → process task: discover and validate `search`, select the
exact result path from its JSON metadata, then discover and validate `get`.
Download to a named local file (never stdout), process that local file, and
report the output path or a concise result. A later upload, share-link, or
replacement is a separate externally visible action and needs its own
discovery, safety policy, and authorization.

## Boundaries

- Never put tokens, auth codes, app secrets, environment dumps, or auth-file
  contents in prompts, commands, logs, JSON fixtures, tool results, commits,
  or artifacts. Refer to secret names and paths only when needed.
- Do not use `DBXCLI_ACCESS_TOKEN=value` inline. Pass an already-provisioned
  secret through the execution environment. Keep `DBXCLI_AUTH_FILE` outside
  the repository and do not read, upload, or commit it.
- Never send binary file data through a tool result. For `get` or
  `share-link download`, download to a local file and report its path and
  metadata. `local operand -` is a byte stream and cannot be combined with
  JSON output.
- Do not use this skill to expose shared links, alter permissions, overwrite,
  move, restore, or delete without user-authorized scope.
Pliki w paczce (5)
  • SKILL.md 5 KB
  • agents/openai.yaml 1 KB
  • references/automation.md 2 KB
  • references/safety.md 2 KB
  • references/tool-integration.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie dbxcli.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 7d57b712bad4 (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

  • 90share-dropbox-content
    Udostępnia pliki i foldery Dropbox przez tworzenie linków, sprawdzanie istniejących linków i wyjaśnianie ich stanu, tylko na wyraźną prośbę.
  • 90inspect-dropbox-file
    Sprawdza plik lub folder w Dropboksie przez metadane, linki udostępniania i w razie potrzeby zawartość, odpowiadając, czym jest plik, czy jest udostępniony i kiedy się zmienił.
  • 100agentio-dropbox
    Obsługuje Dropbox przez CLI agentio: listowanie, wyszukiwanie, pobieranie, wysyłanie, przenoszenie, kopiowanie, usuwanie i linki do udostępniania.
  • 90dropbox
    Integruje z API Dropbox przez zarządzany OAuth: pliki, foldery, wyszukiwanie, metadane i przechowywanie w chmurze.
  • 91dropbox
    Przeszukuje, czyta, wysyła i porządkuje pliki w Dropbox, zbiera przesyłki od klientów i tworzy linki udostępnienia.
  • 100dropbox-webhooks
    Odbiera i weryfikuje webhooki Dropbox API: odpowiada na wyzwanie weryfikacyjne, sprawdza podpis X-Dropbox-Signature i pobiera zmiany przez /files/list_folder/continue.

Uwagi i zgłoszenia

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