image-upload

Name: image-upload
Availability: InStock
Author: iamzifei

Upload local images to hosting providers and return formatted shareable URLs.

6|Updated Jan 15, 2026

Search Tags:#api #cli #upload #image-upload #image-hosting #catbox #imgbb

Ready to run

npx skills add https://github.com/iamzifei/image-upload-skill --skill image-upload-iamzifei

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: image-upload
Source: https://github.com/iamzifei/image-upload-skill/tree/main
Command: npx skills add https://github.com/iamzifei/image-upload-skill --skill image-upload-iamzifei

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Uploading local images to public hosting services and producing ready-to-share links and embeddings is repetitive and error-prone; this Skill automates the entire workflow so users can get direct links or formatted output without manual provider API calls.

Core Features & Use Cases

Zero configuration default: Works out of the box with Catbox.moe for anonymous uploads.
Multiple providers: Supports Catbox, ImgBB, Imgur, Freeimage, ImgHippo, and Weibo with provider-specific handling.
Multiple output formats: Produces plain URL, Markdown, HTML, and BBCode, plus viewer and delete links when available.
CLI and programmatic use: Use from the command line or import the uploadImage function in code; supports environment-based configuration and robust error handling for missing files, size/type limits, auth failures, and network retries.

Quick Start

Ask Claude to upload an image by providing a local file path and optionally specifying a provider or output format.

Frequently Asked Questions about image-upload

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I upload a local image and get a Markdown shareable URL?▼

You can upload local images to hosting providers and get shareable URLs without manual API calls. It supports Catbox, ImgBB, Imgur, Freeimage, ImgHippo, and Weibo, returning formatted outputs in URL, Markdown, HTML, and BBCode.

Can I upload images to ImgBB or Imgur from the command line?▼

Yes, you can upload images to ImgBB, Imgur, Catbox, Freeimage, ImgHippo, and Weibo from the command line. The tool supports CLI usage and programmatic imports with environment-based configuration and robust error handling.

Do I need an API key to upload images to Catbox?▼

No, you do not need an API key for Catbox. The tool works out of the box with Catbox.moe for anonymous uploads, requiring zero configuration to generate direct links and formatted embed codes for local image files.

What is the best way to handle image upload failures and size limits?▼

The best way to handle upload failures is using a tool that validates file size and type against provider limits. It includes robust error handling for missing files, auth failures, and network retries with timeout logic.

Does the image upload tool return HTML and BBCode embeds?▼

Yes, the image upload tool returns HTML and BBCode embeds. Alongside the plain URL, it produces Markdown, HTML, and BBCode formatted outputs, plus viewer and delete links when available from the hosting provider.