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").

Instructions

Follow these steps exactly:

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. Resolve the API key

• Check if $LABNOCTURNE_API_KEY is set: run echo $LABNOCTURNE_API_KEY .

• If the variable is empty or unset, generate a test key automatically: curl -s https://images.labnocturne.com/key

The response is JSON: {"api_key": "ln_test_..."} . Extract the api_key value and use it for the upload. Tell the user a temporary test key was generated (7-day file retention, 10MB limit).

• If the variable is set, use its value.

3. Resolve the base URL

• Use $LABNOCTURNE_BASE_URL if set, otherwise default to https://images.labnocturne.com .

4. Upload the file

Run:

curl -s -X POST
-F "file=@<resolved_path>"
-H "Authorization: Bearer <api_key>"
<base_url>/upload

5. 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 — the response body is:

{ "error": { "message": "Human-readable message", "type": "error_category", "code": "machine_readable_code" } }

Show the error message to the user and suggest a fix based on the error code:

code

Suggested fix

missing_api_key

Set $LABNOCTURNE_API_KEY or let the skill generate a test key

invalid_api_key

Check that $LABNOCTURNE_API_KEY is correct, or unset it to auto-generate a test key

invalid_auth_format

The key should be passed as Bearer <key> — this is handled automatically

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

quota_exceeded

Storage quota full. Delete old files with curl -X DELETE <base_url>/i/<id> or upgrade

unsupported_file_type

Only jpg, png, gif, webp, svg are supported

upload_failed

Server error — try again in a moment