uploadthing_skill

Overview

This skill provides a lightweight interface to Uploadthing file hosting — upload, list, manage, and generate CDN URLs for files using the Uploadthing API. It is built for AI agents and automation: Python standard library only, zero external dependencies. Use it to add reliable file storage, metadata handling, and usage tracking to scripts and web apps.

How this skill works

The skill wraps Uploadthing API calls into simple CLI commands and JSON outputs. It sends requests directly to Uploadthing (no local storage), parses file metadata and usage stats, and returns results to stdout or a human-readable format. Common operations include upload, list, delete, rename, URL generation, and app configuration retrieval.

When to use it

• Add file hosting to an automation workflow or agent without installing dependencies
• Upload files and attach or inspect metadata programmatically
• List and filter stored files and bulk-delete obsolete content
• Generate CDN-ready URLs for delivery to clients or downstream services
• Monitor storage and bandwidth usage for cost and quota management

Best practices

• Provide UPLOADTHING_SECRET as an environment variable and restrict its scope
• Use the JSON output for programmatic pipelines and --human only for debugging
• Paginate or limit file listings to avoid large responses
• Batch deletions with keys to minimize API calls and reduce runtime
• Treat returned CDN URLs as public delivery links and apply access controls externally if needed

Example use cases

• Automated agent that uploads model outputs and stores metadata for later retrieval
• Web app backend that offloads media uploads to Uploadthing and serves files via CDN
• Scheduled cleanup job that lists files older than X days and deletes them in bulk
• Monitoring script that fetches usage stats to alert on bandwidth or storage spikes
• Command-line tooling for developers to rename, inspect, or generate URLs for stored assets