| name | Catbox & Litterbox File Uploader |
| description | Upload local files to Catbox for permanent sharing or Litterbox for temporary sharing. Use when you need a public link for logs, screenshots, archives, media, or other local artifacts. |
| version | 1.0.0 |
| author | Microck |
| upstream | https://github.com/Microck/opendots-microck/tree/main/skills/catbox-upload-skill |
Catbox & Litterbox File Uploader
Use this skill when the user wants a direct public URL for a local file.
- Prefer
litterbox for temporary sharing of logs, builds, screenshots, and one-off artifacts.
- Prefer
catbox for permanent hosting.
- Return the final URL plainly, and for
litterbox also mention the selected expiry window.
Command
Run the bundled uploader script:
bash ~/.neoagent/agent-data/skills/productivity-catbox-upload-skill/scripts/upload.sh /path/to/file
Arguments
file_path (required): local file to upload--service litterbox|catbox (optional): defaults to litterbox--time 1h|12h|24h|72h (optional): only used for litterbox, defaults to 24h--userhash HASH (optional): Catbox account hash for uploads tied to a Catbox account
Examples
Temporary upload with the default 24-hour expiry:
bash ~/.neoagent/agent-data/skills/productivity-catbox-upload-skill/scripts/upload.sh ./logs/server.log
Temporary upload that expires after 1 hour:
bash ~/.neoagent/agent-data/skills/productivity-catbox-upload-skill/scripts/upload.sh ./build/output.zip --time 1h
Permanent upload to Catbox:
bash ~/.neoagent/agent-data/skills/productivity-catbox-upload-skill/scripts/upload.sh ./artifacts/screenshot.png --service catbox
Permanent upload associated with a Catbox account:
bash ~/.neoagent/agent-data/skills/productivity-catbox-upload-skill/scripts/upload.sh ./artifacts/screenshot.png --service catbox --userhash YOUR_HASH
Expected Output
The script prints exactly one URL on success, for example:
https://litterbox.catbox.moe/abc123.png
or:
https://files.catbox.moe/abc123.png
Presenting Results
When the upload succeeds:
- show the returned URL clearly
- mention whether it is temporary or permanent
- if using
litterbox, include the expiration window
Example response:
File uploaded successfully.
Link: https://litterbox.catbox.moe/abc123.png
Expires in: 24 hours
Limits
litterbox: up to 1 GB, temporary, supports 1h, 12h, 24h, and 72hcatbox: up to 200 MB, permanent
Troubleshooting
- If the file does not exist or is unreadable, verify the path first.
- If the upload fails, surface the exact error from the script.
- If
curl is missing, install it before retrying.
- If Catbox rejects the file, the file may exceed the service limit or violate Catbox content rules.
