dropbox-skill

name	dropbox-skill
description	Upload files to Dropbox, download from Dropbox, and create or reuse shared links. Use when the user mentions Dropbox, asks to upload/download/share a file via Dropbox, or wants a shareable link for a file already in Dropbox.
license	MIT
compatibility	Agent Skills-compatible clients with shell access, bash 4+, curl, jq, Dropbox API network access, and the ability to execute files from this skill directory.

dropbox-skill

Dropbox file operations via Dropbox HTTP API v2. Unifies upload, download, and shared-link operations.

Trigger conditions

Invoke this skill when the user says any of:

• "upload X to Dropbox" → use scripts/upload.sh
• "download X from Dropbox" / "get X from Dropbox" → scripts/download.sh
• "share link", "shared link", "Dropbox link", "make a link for X" → scripts/share.sh
• "set up Dropbox", "configure Dropbox", or when ~/.config/dropbox-skill/credentials.json does not exist → scripts/setup.sh

Prerequisites (check before any operation)

Before running upload/download/share, verify the credentials file exists:

test -f ~/.config/dropbox-skill/credentials.json

If it does not exist, tell the user:

Dropbox is not set up yet. I can run the setup flow — it will ask for your app key, app secret, and an authorization code from a browser URL. Proceed?

Only run setup.sh after the user confirms.

Path rules

• Dropbox paths MUST start with / (e.g. /Papers/draft.pdf). Reject relative paths.
• If the user gives a bare filename (e.g. "report.pdf"), ask which Dropbox folder before acting.

Script usage

All scripts live in this skill directory's scripts/ folder. If your client exposes the skill directory path (for example Claude Code via CLAUDE_SKILL_DIR), use it. Otherwise resolve the script path relative to this SKILL.md file.

setup.sh

Interactive one-time bootstrap. Takes stdin input for app key, app secret, and authorization code.

bash scripts/setup.sh

upload.sh

Upload local → Dropbox. Auto-chooses single-shot vs chunked session based on file size.

bash scripts/upload.sh <local_path> <dropbox_path>

Prints a one-line JSON summary on success: {"path":"...","size":N,"content_hash":"..."}

download.sh

Download Dropbox → local. Refuses to overwrite existing local files.

bash scripts/download.sh <dropbox_path> [<local_path>]

If <local_path> is omitted, uses basename <dropbox_path> in the current directory. Prints the saved path on stdout.

share.sh

Create (or retrieve existing) shared link.

bash scripts/share.sh <dropbox_path>

Prints the URL on stdout.

Error handling

If any script exits non-zero, show its stderr to the user verbatim. Do not retry auth errors automatically (exit codes 2 and 3) — surface them so the user can re-run setup.

Exit code reference:

• 0 — success
• 1 — bad argument or local filesystem error
• 2 — credentials.json missing (→ user should run setup.sh)
• 3 — refresh token rejected (→ user should re-run setup.sh)
• 4 — Dropbox path not found
• 5 — other API error
• 64 — usage error
• 127 — missing dependency (curl/jq)