Upload Image to Lab Nocturne
Upload an image file to the Lab Nocturne Images API and return the CDN URL.
Invocation
/upload <path> — where <path> is the file to upload. Also triggered naturally (e.g. "upload this screenshot", "host this image", "get me a URL for this png").
Instructions
1. Resolve the file path
- The user provides a file path as the argument (e.g.
/upload ./screenshot.png).
- If no path is given, ask the user which file to upload.
- Verify the file exists using
ls on the path. If it does not exist, tell the user and stop.
- Verify the extension is one of:
jpg, jpeg, png, gif, webp, svg. If not, tell the user the file type is not supported and list the allowed types.
2. Authenticate
Follow the steps in references/auth.md to resolve the API key and base URL.
3. Upload the file
Run:
curl -s -w '\n%{http_code}' -X POST \
-F "file=@\"<resolved_path>\"" \
-H "Authorization: Bearer <api_key>" \
<base_url>/upload
The -w '\n%{http_code}' appends the HTTP status code on a separate line. Parse the last line as the status code and everything before it as the response body.
4. Handle the response
Success (HTTP 201) — the response body is:
{
"id": "img_...",
"url": "https://cdn.labnocturne.com/...",
"size": 123456,
"mime_type": "image/png",
"uploaded_at": "2025-01-01T00:00:00Z"
}
Present to the user:
- Image ID: the
id field
- CDN URL: the
url field
- Size: the
size field, formatted as human-readable (e.g. "1.2 MB")
Error — see references/auth.md for common error codes. Additional upload-specific codes:
code |
Suggested fix |
missing_file |
Internal skill error — report to user |
file_size_exceeded |
Test keys are limited to 10MB, live keys to 100MB. Compress the image or upgrade. Use /stats to check current usage |
quota_exceeded |
Storage quota full. Use /files to find old uploads, then /delete <id> to free space, or upgrade |
unsupported_file_type |
Only jpg, png, gif, webp, svg are supported |
upload_failed |
Server error — try again in a moment |
If the server returns a non-JSON response or an unexpected HTTP status (e.g. 502, 503), tell the user the API may be temporarily unavailable and suggest retrying.
1---2name: image-upload3description: Upload an image to Lab Nocturne and get an instant CDN URL. Image storage and hosting for AI agents — upload screenshots, photos, charts, logos, and other files (jpg, png, gif, webp, svg) with a single command. No signup required. Alternative to S3, Cloudflare Images, or Imgur for agent workflows. Use this skill whenever the user wants to upload, host, publish, or share an image file — even if they just say 'put this image somewhere' or 'get me a URL for this'. Triggered by /upload <path> or naturally.4---56# Upload Image to Lab Nocturne78Upload an image file to the Lab Nocturne Images API and return the CDN URL.910## Invocation1112`/upload <path>` — where `<path>` is the file to upload. Also triggered naturally (e.g. "upload this screenshot", "host this image", "get me a URL for this png").1314## Instructions1516### 1. Resolve the file path1718- The user provides a file path as the argument (e.g. `/upload ./screenshot.png`).19- If no path is given, ask the user which file to upload.20- Verify the file exists using `ls` on the path. If it does not exist, tell the user and stop.21- Verify the extension is one of: `jpg`, `jpeg`, `png`, `gif`, `webp`, `svg`. If not, tell the user the file type is not supported and list the allowed types.2223### 2. Authenticate2425Follow the steps in `references/auth.md` to resolve the API key and base URL.2627### 3. Upload the file2829Run:30```bash31curl -s -w '\n%{http_code}' -X POST \32 -F "file=@\"<resolved_path>\"" \33 -H "Authorization: Bearer <api_key>" \34 <base_url>/upload35```3637The `-w '\n%{http_code}'` appends the HTTP status code on a separate line. Parse the last line as the status code and everything before it as the response body.3839### 4. Handle the response4041**Success** (HTTP 201) — the response body is:42```json43{44 "id": "img_...",45 "url": "https://cdn.labnocturne.com/...",46 "size": 123456,47 "mime_type": "image/png",48 "uploaded_at": "2025-01-01T00:00:00Z"49}50```5152Present to the user:53- **Image ID**: the `id` field54- **CDN URL**: the `url` field55- **Size**: the `size` field, formatted as human-readable (e.g. "1.2 MB")5657**Error** — see `references/auth.md` for common error codes. Additional upload-specific codes:5859| `code` | Suggested fix |60|---|---|61| `missing_file` | Internal skill error — report to user |62| `file_size_exceeded` | Test keys are limited to 10MB, live keys to 100MB. Compress the image or upgrade. Use `/stats` to check current usage |63| `quota_exceeded` | Storage quota full. Use `/files` to find old uploads, then `/delete <id>` to free space, or upgrade |64| `unsupported_file_type` | Only jpg, png, gif, webp, svg are supported |65| `upload_failed` | Server error — try again in a moment |6667If the server returns a non-JSON response or an unexpected HTTP status (e.g. 502, 503), tell the user the API may be temporarily unavailable and suggest retrying.
jjenkins