Gumroad Image Uploader
Bulk-upload cover images and thumbnails to Gumroad products using simple CSV manifests or folder mapping.
- Apply new branding across hundreds of Gumroad products simultaneously
- Map local image folders to products using custom permalinks automatically
- Validate image integrity and file size before attempting API uploads
Secure checkout via Stripe
Included in download
- Apply new branding across hundreds of Gumroad products simultaneously
- Map local image folders to products using custom permalinks automatically
- terminal, network, file_read automation included
- Includes example output and usage patterns
See it in action
A real example of what this skill takes in and produces.
Sample output
**Gumroad Image Upload Summary** | Row | Custom Permalink | Image | Status | Product ID | Message | |---:|---|---|---|---|---| | 1 | pro-preset | covers/pro-preset.png | success | xYz987 | Cover image uploaded | | 2 | light-pack | covers/light-pack.webp | success | aBc123 | Cover image uploaded | Successes: 2 | Failures: 0
Gumroad Image Uploader
Bulk-upload cover images and thumbnails to Gumroad products using simple CSV manifests or folder mapping.
Secure checkout via Stripe
Included in download
- Apply new branding across hundreds of Gumroad products simultaneously
- Map local image folders to products using custom permalinks automatically
- terminal, network, file_read automation included
- Includes example output and usage patterns
- Instant install
See it in action
A real example of what this skill takes in and produces.
Sample output
**Gumroad Image Upload Summary** | Row | Custom Permalink | Image | Status | Product ID | Message | |---:|---|---|---|---|---| | 1 | pro-preset | covers/pro-preset.png | success | xYz987 | Cover image uploaded | | 2 | light-pack | covers/light-pack.webp | success | aBc123 | Cover image uploaded | Successes: 2 | Failures: 0
About This Skill
What it does
The Gumroad Image Uploader automates the tedious process of updating product cover images and thumbnails across your Gumroad catalog. Instead of manually clicking through the web dashboard for every item, this skill enables bulk updates via a simple CSV manifest or a structured image folder.
Why use this skill
Manual uploads are prone to error and incredibly time-consuming for large catalogs. This developer-focused tool provides a robust automation layer that includes pre-flight checks to ensure your assets meet Gumroad's requirements before hitting the API. It handles token validation, file integrity checks, and size warnings automatically.
Unlike basic prompting, this skill provides logic for mapping local files to remote products using custom permalinks, handles multipart form-data requirements, and manages API rate limits or missing product scenarios gracefully.
Supported tools
- Gumroad API v2 integration
- Python-based execution environment
- Pillow for image validation and corruption detection
- CSV and local filesystem processing
- Support for JPG, PNG, and WebP formats
Use Cases
- Apply new branding across hundreds of Gumroad products simultaneously
- Map local image folders to products using custom permalinks automatically
- Validate image integrity and file size before attempting API uploads
- Generate detailed audit logs of successful and failed cover updates
Known Limitations
- Image files must be named exactly {custom_permalink}.jpg/png/webp - Recommended size: 1024x768 (Gumroad will resize if different) - Max file size: 10MB per image (Gumroad limit) - Skips products that don't exist (no error, just logged) - No automatic image optimization (upload as-is) - Does not generate images — use Product Image Creator for that
How to Install
mkdir -p ~/.claude/skills && curl -sL https://www.agensi.io/api/install/gumroad-image-uploader | tar xz -C ~/.claude/skills/Free skills install directly. Paid skills require purchase - use the download button above after buying.
Reviews
No reviews yet - be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
Early access skill
Be the first to review this skill.
Only users who have downloaded or purchased this skill can leave a review.
Security Scanned
Passed automated security review
Permissions
Allowed Hosts
File Scopes
Gumroad Image Uploader needs terminal access to run the batch upload script. Network access calls the Gumroad API to update product cover images. File read access reads image files from the specified folder. Environment variables read the Gumroad access token from .env. No write, browser, or other network access required.
Works with Claude Code and Codex. Requires Gumroad access token in .env file. No other dependencies.