Dropbox Skill

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

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 []

If ` is omitted, uses basename ` in the current directory. Prints the saved path on stdout.

share.sh

Create (or retrieve existing) shared link.

bash scripts/share.sh

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)

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Axect
• Source: Axect/dropbox-skill
• License: MIT

Install and usage instructions live in the source repository linked above.