ephemeral-file-sharing
Skill2 starsChanged 2 months agoMITView on GitHub
Expiring public web links for files, CLI-only (gofile.io).
In this repository58 other files it gives its agents.
- ad-hoc-script-verificationSkill
- architecture-diagramSkill
- blocked-page-recoverySkill
- cadquery-enclosure-designSkill
- canonical-thumbnailSkill
- circuit-designSkill
- competitor-news-monitorSkill
- component-alternativesSkill
- debugging-hermes-tui-commandsSkill
- docker-container-update-checkSkill
- document-to-action-itemsSkill
- docxSkill
- email-inbox-triageSkill
- embedded-porting-patternsSkill
- excalidrawSkill
- flash-game-researchSkill
- flutter-android-buildSkill
- flutter-content-renderingSkill
- github-code-reviewSkill
- githubSkill
- goatcounter-analyticsSkill
- google-oauth-file-pollSkill
- grounded-citationsSkill
- hermes-agent-skill-authoringSkill
- hermes-gateway-slash-commandSkill
- hermes-gateway-supervisionSkill
- jellyseerr-watch-suggestionsSkill
- maintained-fork-publishingSkill
- meeting-action-itemsSkill
- native-mcpSkill
- obsidian-mapsSkill
- pdf-flattenSkill
- pdfSkill
- pdf-surgical-editsSkill
- planSkill
- product-price-monitorSkill
- psp-developmentSkill
- psp-homebrew-testingSkill
- psp-prx-plugin-maintenanceSkill
- python-debugpySkill
- python-webapp-patternsSkill
- reddit-readingSkill
- retro-fansiteSkill
- reverse-proxy-websocket-debuggingSkill
- rss-feedsSkill
- simplify-codeSkill
- sketchSkill
- skit-thumbnailSkill
- spikeSkill
- subagent-driven-developmentSkill
- test-driven-developmentSkill
- usb-device-enumerationSkill
- weekly-review-planningSkill
- wiki-media-asset-pipelineSkill
- windows-c-build-toolchainSkill
- windows-crash-forensicsSkill
- writing-plansSkill
- yt-dlp-anti-botSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 2 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 21
Never upload the real (possibly 1 GB+) file blind.
- Very specific: line 47
Do NOT hand-build the stream URL https://{server}.gofile.io/download/{contentId}/{filename} — it 301s to the download page.
- Very specific: line 52
Run the ssh + curl upload as a background terminal with notify_on_complete=true (upload takes minutes on typical upstream).
- Very specific: line 53
Keep the channel alive with ssh -o ServerAliveInterval=30.
- Distinctive: line 61
No LRU: an expiring link should still be flagged in the reply ("dies ~10 days from upload unless downloaded") so the user isn't surprised …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Ephemeral File Sharing
Give the user a public download link that expires on its own — no account, pure CLI. Use when they say "upload X to the web", "send someone a limited link", "a link that expires in a week". Sibling of homelab-file-hosting (self-hosted permanent links); use THIS skill for external hosts with built-in expiry.
Golden rule: probe before committing
Never upload the real (possibly 1 GB+) file blind. Send a tiny probe (~50 bytes) to the candidate host and confirm you get a working JSON link back. Ephemeral hosts drift without warning:
- file.io — root 301s to www.file.io, POST to either returns 405/Gatsby SPA (API gone as of Sep 2026). Old tutorials saying
curl -F "file=@f" https://file.ioare stale — do not trust them, probe. - tmpfiles.org —
/api/v1/uploadreturned empty body. - transfer.pcloud.com — returned HTML page, not JSON (their API wants different params/endpoint).
- gofile.io — verified working Sep 2026. Use it.
gofile.io recipe (verified Sep 2026)
1. Upload (guest, no auth, ~1 GB fine)
curl -s --max-time 5400 -F "file=@/path/to/file" "https://upload.gofile.io/uploadfile"Response JSON fields to use:
data.downloadPage— the link to share (https://gofile.io/d/XXXX)data.size+data.md5— server-computed; matchdata.sizeagainst local file size for integritydata.guestToken/data.code/data.id— only needed for API management calls
2. Expiry semantics (free tier — report to user honestly)
- Guest/standard uploads kept ~10 days; the clock resets on every download, so active content lives longer, inactive files die at ~10 days. Premium = permanent.
- State this to the user when they ask for "a week or so": "kept ~10 days, resets each download."
3. Verify BEFORE handing over the link
curl -s -o /dev/null -w "%{http_code}\n" --max-time 30 "https://gofile.io/d/<CODE>" # expect 200- Do NOT hand-build the stream URL
https://{server}.gofile.io/download/{contentId}/{filename}— it 301s to the download page. ThedownloadPagelink is canonical. api.gofile.io/contents/{id}?wt=<guestToken>may returnerror-tokenfor guest tokens — expected, don't chase it; the page 200 + size match is the real verification.
4. Pushing big files from the homelab
Stream from the server that holds the file — never copy 1 GB to the local box first:
- Run the ssh + curl upload as a background terminal with
notify_on_complete=true(upload takes minutes on typical upstream). - Keep the channel alive with
ssh -o ServerAliveInterval=30. --max-time 5400(~90 min) is a sane ceiling for 1 GB.
Pitfalls
- Hosts drift: probe-first catches dead APIs before you burn a big upload. Re-probe any host older than a few months, even one documented here.
- Guest links are not revocable and not password-protected — for sensitive/durable shares use
homelab-file-hosting(self-hosted, you control deletion) instead. - gofile free tier has a download-speed cap for guests; fine for casual sharing, bad for many recipients.
- No LRU: an expiring link should still be flagged in the reply ("dies ~10 days from upload unless downloaded") so the user isn't surprised later.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

