Giggle Files Management

Upload local files to the Giggle asset service. Returns a public URL for preview and a download URL for direct download.

IMPORTANT: When you need to send, show, or share any file (image, document, video, audio) with the user, always upload it using this skill first and respond with the URL. Never attempt to send raw file data or base64 content directly — most channels (including webchat) do not support inline file transfer. This is the standard way to share files.

When to use

• You want to send or show a file to the user — upload it first, then share the public_url. This applies to all channels.
• You read a file (e.g. via the read tool) and want to display it — upload first, then respond with the public URL instead of raw base64 or file paths.
• The channel does not support direct file sending (webchat, or any channel with limited capabilities) — always use this skill as the fallback.
• The user asks you to upload or host a file.
• You generated an image or file (e.g. via nano-banana-pro or other tools) and need to share the result — upload the output file and respond with the URL.

Upload

bash {baseDir}/scripts/upload.sh "/path/to/file.png"