# File Uploads

> Upload local files, archives, generated artifacts, images, videos, or other hand-off deliverables to the user's private Zipline instance and return a shareable raw download link. Use when the user asks to upload, host, share, hand off, or provide a link to a file.

- Skill: `emmsixx/file-uploads` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add emmsixx/file-uploads`
- Raw SKILL.md: https://api.skillmd.com/api/skills/emmsixx/file-uploads/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: emmsixx (https://skillmd.com/u/emmsixx)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/emmsixx/file-uploads

---


# File Uploads

Upload a single local file to the user's Zipline instance at `phobos.m6.rs` and return its raw link.

## Workflow

1. Confirm that the requested artifact exists as a regular local file. If the user wants a directory or several files handed off together, create an appropriate archive first, then upload that archive.
2. Resolve `scripts/upload.py` relative to this `SKILL.md`; do not assume the current working directory is the skill directory.
3. Run:

   ```bash
   python3 /absolute/path/to/file-uploads/scripts/upload.py "/absolute/path/to/file"
   ```

4. On success, the script prints exactly one URL. Return that URL to the user as a clickable link in the chat.

The script requests Zipline's `random` filename format and always emits the canonical raw form:

```text
https://phobos.m6.rs/raw/filename.extension
```

## Rules

- Never display, log, echo, or pass `PHOBOS_TOKEN` on the command line. The script reads it directly from the environment.
- Never invent or predict the resulting URL. Use only the URL printed after a successful upload.
- Do not rename, move, delete, or otherwise modify the source file unless the user explicitly asks.
- Do not upload secrets, credentials, private keys, environment files, or other sensitive material unless the user explicitly identifies the exact file and asks for it to be uploaded.
- If the upload fails, report the error and do not claim the file was uploaded.
- Upload one file per script invocation. For multiple separate links, invoke the script once for each file and clearly associate every link with its source file.

## Setup

`PHOBOS_TOKEN` must be available in the agent's environment:

```bash
export PHOBOS_TOKEN="your-zipline-token"
```

If it is missing, ask the user to configure it in their environment. Never ask them to paste the token into chat.