assistant-skills/s2-storage/SKILL.md

name	description	version
s2-storage	Upload and manage files on S2, a self-hosted file storage service at s2.connorrhodes.com. Use when the user says "upload to s2", "store this file", "put this on s2", or when any other skill needs to upload a file and get a persistent URL back.	1.0.0

S2 Storage

Upload files to s2.connorrhodes.com via the API and get back a persistent URL.

Endpoint

• URL: POST https://api.connorrhodes.com/agent/s2_upload
• Auth: x-api-key: LT6CXiLT5cEApfqtThz17bENr6OLP804FepOMqa1tZkfTGXiiCcSFlupl6gaYeX
• Response: JSON string — the public URL of the uploaded file

Script

Use scripts/s2_upload.py for all uploads. Do not rewrite the curl command inline.

# Upload and print the URL
uv run ~/notes/skills/s2-storage/scripts/s2_upload.py /path/to/file.pdf

# Upload and delete the local file afterwards
uv run ~/notes/skills/s2-storage/scripts/s2_upload.py /path/to/file.pdf --delete

The script prints the S2 URL to stdout on success and exits non-zero on failure.

Rules

• Always delete the local file after upload unless the user explicitly wants to keep it. Pass --delete to the script.
• The returned URL is permanent and publicly accessible — treat it as the canonical reference going forward.
• When another skill needs to upload a file (e.g., log-work-expense, brag-sheet), use this script rather than reimplementing the curl call.