SkillsAdd

merit-systems/x402scan-skills

upload-and-share

Upload files to the cloud and get shareable public URLs using agentupload.dev (x402 micropayments).

First seen Feb 11, 2026

Installation

$ npx skills add merit-systems/x402scan-skills --skill upload-and-share
View on skills.sh ↗ GitHub repository ↗

Summary

  • Upload files to the cloud and get shareable public URLs using agentupload.dev (x402 micropayments).
  • Use when the user asks to upload a file, share a file via URL, host a file, make a file publicly accessible, or needs a download link for any file.
  • Triggers on phrases like "upload this", "share this file", "get me a link", "host this file", "make this downloadable", or any request to put a local file on the internet.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

find-skills Same topic
vercel-labs/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "fi…

3.3M installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-prepare Same topic
microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Te…

568.3K installs

Also in this package

Other skills from merit-systems/x402scan-skills.

npx skills add merit-systems/x402scan-skills
web-research 57 social-intelligence 53 data-enrichment 40 people-property 37 local-search 34 news-shopping 31 wallet 26 media-generation 25 enriching-data 1

Browse all from merit-systems/x402scan-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 3
Default branch master
Open issues 2
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,498 B
  • docs SUMMARY.md 443 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 11 installs

SKILL.md

Upload and Share via agentupload.dev

Upload any local file to S3-backed cloud storage via x402 micropayments. Returns a permanent public URL. No API keys needed.

Workflow

1. Check wallet balance

x402.get_wallet_info()

Ensure sufficient USDC balance for the chosen tier. If balance is low, show the deposit link.

2. Determine the tier

Pick the smallest tier that fits the file. Check file size first with ls -la or wc -c.

Tier Max Size Cost
10mb 10 MB $0.10
100mb 100 MB $1.00
1gb 1 GB $10.00

3. Buy the upload slot

x402.fetch(
  url: "https://agentupload.dev/api/x402/upload",
  method: "POST",
  headers: {"Content-Type": "application/json"},
  body: {"filename": "<name>", "contentType": "<mime>", "tier": "<tier>"}
)

Content type guidance: Use the correct MIME type for the file. Common types:

  • text/csv, application/json, text/plain for data files
  • application/pdf for PDFs
  • image/png, image/jpeg for images
  • application/zip for archives
  • application/octet-stream as a fallback for unknown types

The response contains uploadUrl (temporary, 1hr TTL) and publicUrl (permanent for 6 months).

4. Upload the file via curl

Use Bash to PUT the file to the returned uploadUrl:

curl -s -X PUT "<uploadUrl>" -H "Content-Type: <mime>" --data-binary @/absolute/path/to/file

Critical: Use --data-binary (not -d) to preserve binary content. Use the absolute path.

5. Share the public URL

Present the publicUrl to the user. This URL is publicly accessible immediately and remains live for 6 months.

Listing Previous Uploads

To list uploads for the current wallet:

x402.fetch_with_auth(
  url: "https://agentupload.dev/api/x402/uploads",
  method: "GET"
)

This uses SIWX (Sign-In With X) authentication, not x402 payment.

Key Details

  • No API keys required - payment is the authentication
  • Upload URLs expire in 1 hour - upload promptly after buying the slot
  • Public URLs last 6 months from purchase date
  • Any file type accepted - contentType is advisory for the browser, not a restriction
  • Discovery endpoint: x402.discoverapiendpoints(url: "https://agentupload.dev";) if you need to verify endpoints

Common Patterns

Upload a file the user just created: Skip discovery, go straight to wallet check + buy slot + upload.

Upload multiple files: Buy separate slots for each file. Slots can be purchased in parallel but uploads must use the correct uploadUrl for each.

User asks to "share" or "send" a file: Upload it and present the public URL. The URL can be shared anywhere.

Error Handling

  • Insufficient balance: Show the deposit link from getwalletinfo
  • File too large for tier: Suggest the next tier up
  • Upload URL expired: Buy a new slot (the previous payment is non-refundable)
  • curl fails: Verify the file path exists and the uploadUrl is correctly quoted