copycat

skills/file-upload/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: file-upload
+description: 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
+
+```bash
+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: 
+
+```bash
+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.