ImgBB API

Upload images to ImgBB via local file, URL, or base64 and get shareable direct links, supporting batch uploads and optional expiration settings.

Security Scan

The skill's code and instructions match its stated purpose (uploading images to ImgBB) and request only a single API key plus an optional local config file; minor metadata inconsistencies are present but not evidence of malicious behavior.

Purpose & Capability

The name, description, SKILL.md, and scripts/imgbb.py all consistently implement an ImgBB uploader. The only mismatch is registry metadata (which lists no required env vars or binaries) vs SKILL.md and the script that expect python3, the requests library, and an IMGBB_API_KEY — the code legitimately needs those.

Instruction Scope

Runtime instructions and the script stay within the stated purpose: they read an API key (env or ~/.imgbb_api_key), accept a local file/URL/base64, and POST to https://api.imgbb.com/1/upload. There are no instructions to collect unrelated files, scan the system, or exfiltrate data to unexpected endpoints.

Install Mechanism

This is an instruction-only skill with an included Python script (no installer). SKILL.md indicates python3 and the requests pip package are required — reasonable for this task. There is no external download URL or archive extraction; risk from install mechanism is low.

Credentials

The only secret the skill uses is an ImgBB API key provided via IMGBB_API_KEY, --key, or a local config file (~/.imgbb_api_key). That is proportionate to an image-uploading tool. The minor issue: registry metadata does not declare IMGBB_API_KEY while SKILL.md and code do, which is an inconsistency callers should be aware of.

Persistence & Privilege

The skill does not request persistent platform privileges. It can optionally write a small config file to the user's home (~/.imgbb_api_key) when --set-key is used — this is limited in scope and expected for convenience. always is false and the skill does not modify other skills or system-wide settings.

Assessment

This skill appears to do exactly what it says: upload images to ImgBB. Before installing, be aware that it expects an ImgBB API key (IMGBB_API_KEY or supplied via --key) and can save that key to ~/.imgbb_api_key if you use --set-key. The registry metadata omits the declared env requirement (IMGBB_API_KEY) — check that you provide the key securely and only give the key needed for ImgBB. If you prefer not to store the key on disk, pass it per-run with --key or via an environment variable.

Upload images to ImgBB and get shareable URLs.

When This Skill Activates

This skill triggers when user wants to upload images to the web for sharing.

Reasoning Framework

Step	Action	Why
1	CHECK	Verify API key is available
2	PREPARE	Get image path or URL
3	UPLOAD	Send to ImgBB API
4	RETURN	Return shareable URL

---

Setup

export IMGBB_API_KEY="your_api_key_here"
# or
echo "your_api_key" > ~/.imgbb_api_key

Get API Key

1. Go to https://api.imgbb.com/
2. Click "Get API Key"
3. Copy your API key

---

Decision Tree

├── Upload single image → python imgbb.py image.jpg
├── Upload from URL → python imgbb.py --url "URL"
├── Custom name → python imgbb.py image.jpg --name myimg
├── Set expiration → python imgbb.py image.jpg --expiration 3600
├── Batch upload → python imgbb.py --batch ./folder/
└── JSON output → python imgbb.py image.jpg --json

---

Usage

# Upload file
python imgbb.py image.jpg

# With custom API key
python imgbb.py image.jpg --key YOUR_KEY

# From URL
python imgbb.py --url "https://..."

# Batch upload
python imgbb.py --batch ./folder/

# JSON output
python imgbb.py image.jpg --json

Options

Flag	Description
image	Path to image
--key	API key
--url	Upload from URL
--name	Custom name
--expiration	Expiry seconds
--json	JSON output
--batch	Batch folder
--set-key	Save API key

---

Troubleshooting

No API key found

• Fix: Set IMGBB_API_KEY env or use --key

File not found

• Fix: Check file path is correct

Invalid image format

• Fix: Use JPG, PNG, GIF, or WEBP

Image too large

• Fix: Compress under 32MB

---

Quick Reference

Task	Command
Upload	python imgbb.py image.jpg
URL	python imgbb.py --url "URL"
Batch	python imgbb.py --batch ./folder/
JSON	python imgbb.py image.jpg --json