← Back to Skills Marketplace
327
Downloads
1
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install imgbb-api
Description
Upload images to ImgBB via local file, URL, or base64 and get shareable direct links, supporting batch uploads and optional expiration settings.
README (SKILL.md)
ImgBB API
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
- Go to https://api.imgbb.com/
- Click "Get API Key"
- 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_KEYenv 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 |
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill
Name: imgbb-api
Version: 1.1.2
The skill bundle is a legitimate implementation of an ImgBB API client for uploading images. The Python script (scripts/imgbb.py) uses the standard 'requests' library to interact with the official ImgBB API endpoint and handles API keys through environment variables or a local configuration file (~/.imgbb_api_key) without any signs of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install imgbb-api - After installation, invoke the skill by name or use
/imgbb-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.2
- Added "requests" to the required Python packages in the setup metadata.
- No changes to user-facing functionality or interface.
v1.1.1
- Patch update with internal changes to scripts/imgbb.py.
- No changes to documentation or public API.
- Version bumped to 1.1.1.
v1.1.0
v1.1.0: Added guidance and troubleshooting for easier use
- Introduced reasoning framework and step-by-step decision tree for uploading images.
- Added troubleshooting section to address common issues (API key, file errors, size limits).
- Updated options and quick reference tables for clearer usage.
- Improved documentation with explicit activation and API key setup guidance.
v1.0.0
Initial release – upload images to ImgBB and obtain shareable direct URLs.
- Supports uploading from local files, URLs, and Base64 data.
- Offers bulk image upload and custom expiration for uploads.
- Multiple authentication methods: command-line flag, environment variable, or config file.
- Returns useful response fields like direct link, viewer link, thumbnail, and delete link.
- Python script includes options for naming, batch upload, JSON output, and more.
Metadata
Frequently Asked Questions
What is ImgBB API?
Upload images to ImgBB via local file, URL, or base64 and get shareable direct links, supporting batch uploads and optional expiration settings. It is an AI Agent Skill for Claude Code / OpenClaw, with 327 downloads so far.
How do I install ImgBB API?
Run "/install imgbb-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is ImgBB API free?
Yes, ImgBB API is completely free (open-source). You can download, install and use it at no cost.
Which platforms does ImgBB API support?
ImgBB API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ImgBB API?
It is built and maintained by KeXu9 (@kexu9); the current version is v1.1.2.
More Skills