fleet/skills/file-upload/SKILL.md

name, description

name	description
file-upload	When a user asks to upload a file, or one is needed for PR descriptions, use this skill.

File upload

Upload files to https://files.gitcoffee.dev and return the permanent public URL from the reponse body. Authenticate with FILE_HOST_TOKEN. If it is unset, tell the user instead of guessing.

Upload

curl -sS --fail-with-body -X PUT -T <path-to-file> \
  -H "X-Upload-Token: $FILE_HOST_TOKEN" \
  "https://files.gitcoffee.dev"

• Use only the file's basename for <filename>, such as login-flow.mp4. The server slugifies it and adds a random suffix, so names do not need to be unique.
• Treat the response body as the permanent public URL and use it directly.
• On HTTP 401, report that the token is wrong or unset. Do not retry.

Use the URL in GitHub/my selfhosted Gitea

• Embed images (png, jpg, gif, webp) as ![description](URL)
• Link videos (mp4, mov, webm) as [screen recording](URL) because inline video players are not well supported.
• When an inline preview genuienly helps and the clip is shorter than about 30 seconds, also upload a GIF preview:

ffmpeg -i recording.mp4 -vf "fps=10,scale=800:-1" -loop 0 preview.gif

Embed the GIF and link the full-quality video below it.