zipbox-image

Read images via OpenRouter vision models and generate media through a metered fal.ai API.

1|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/tribes-protocol/trading-harness --skill zipbox-image-tribes-protocol
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zipbox-image
Source: https://github.com/tribes-protocol/trading-harness/tree/main/skills/zipbox-image
Command: npx skills add https://github.com/tribes-protocol/trading-harness --skill zipbox-image-tribes-protocol

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Your agent harness may not be able to see images or generate media with a specific model. This Skill fills both gaps: it reads images through an OpenRouter vision fallback and generates images, video, or other media through the platform's metered image API backed by fal.ai, without exposing any credentials. ## Core Features & Use Cases - Image Reading Fallback: Sends base64-encoded images to an OpenRouter vision model when the harness cannot render images natively, with guidance on model selection, downscaling, and argv-size limits. - Metered Media Generation: Runs tribes-image generate with any fal.ai model id (image, video, upscaler, img2img) in a single blocking call that returns the result JSON directly. - Use Case: A user asks for an oil-painting-style lighthouse image using fal-ai/flux/schnell. The Skill submits the prompt via tribes-image generate, downloads the resulting CDN URL to a local file before it expires, and reports the saved path. ## Quick Start Ask the agent to read the contents of a screenshot it cannot see, or to generate an image with a named fal.ai model and save the result to a local file.

Frequently Asked Questions about zipbox-image

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

FAQPage Schema
How do I read an image my AI agent cannot see?▼

Base64-encode the image and send it as a data URI in an OpenRouter chat completion with a vision-capable model. Downscale to about 1280px first, and build the JSON request in a file to avoid shell argument-length limits.

How do I generate an image with a specific fal.ai model?▼

Run `tribes-image generate` with the fal model id and a JSON `--input` matching that model's parameters. The call submits, waits, and returns the result in one response; download the output URL locally since it expires after one hour.

Can I use an input image for img2img or image-to-video generation?▼

Yes. fal models that accept an image take it as an `image_url`-style field containing a public URL or base64 data URI. Keep the long edge at 2048px or less before encoding to avoid oversized requests.

Why did my image generation fail with a 504 error?▼

A 504 means the platform waited its full roughly 45-minute budget and cancelled the fal job. For image models one retry is reasonable; for video models do not auto-retry, since the original job may still complete.

When should I not use this image skill?▼

Do not use it when your harness already reads images natively or can generate media itself, unless the user named a specific unreachable model. It is a metered fallback that spends wallet credits, not the default path.