skills.rest
iamzifei
iamzifeiCOMMUNITY
Explore all skills by this author →
𝕏@JamesAIGitHub

image-upload

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
One-click install
npx skills add https://github.com/iamzifei/image-upload-skill --skill image-upload-iamzifei
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
joelklabojoelklabo

sketch-upload-pipeline

Diagnose Sketch image upload failures and preview rendering errors.

Community
Intermediate
cihebi2cihebi2

lsky-uploader

Upload images to a self-hosted Lsky Pro instance and return shareable URLs.

Community
Intermediate
hotriluanhotriluan
3

media-processing

Process multimedia files for encoding, conversion, and background removal with FFmpeg and ImageMagick.

Community
Advanced
bestbest
5

chevereto-upload

Upload images to a Chevereto V4 instance and generate shareable URLs.

Community
Intermediate