forge

Generate, inspect, and refine AI images on Fal.ai through a Python CLI with cost caps.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/line7works/tony-skills --skill forge-line7works
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forge
Source: https://github.com/line7works/tony-skills/tree/main/plugins/forge/skills/forge
Command: npx skills add https://github.com/line7works/tony-skills --skill forge-line7works

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Creating on-brand AI images requires writing good prompts, choosing the right model, controlling spend, and iterating on flawed drafts. This Skill turns Claude into a foreman that writes prompts, runs a deterministic Fal.ai CLI, inspects results with vision, fixes problems, and delivers finished images with an auditable cost manifest. ## Core Features & Use Cases - Full generation workflow: estimate cost, draft cheaply, batch shot lists, race models side by side, edit or style-match images, then re-render keepers at finish quality. - Cost control and auditability: every run takes a --cap circuit breaker, writes a manifest.json per run, and supports resume after interruptions without double-paying. - Brand consistency: per-project .forge/brand.json profiles set default models, palettes, and styles folded into every prompt. - Use Case: Ask for a set of marketing hero images for a project; the Skill estimates the cost, drafts on a cheap model, shows you the survivors, and finishes your picks at high resolution with optional transparent cut-outs and export size presets. ## Quick Start Ask the assistant to generate two draft mascot images for your project on the nano model with a $0.50 cap, then finish the one you pick at high quality.

Frequently Asked Questions about forge

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

FAQPage Schema
How do I generate AI images with Fal.ai from Claude?

Run the forge Python CLI with a prompt, model, size, and cost cap, such as gen with --model nano --size 1024 --cap 0.50. Claude writes the prompt, executes the CLI, inspects the output images, and iterates on failures before presenting keepers.

Which Fal.ai image model should I use for logos and icons?

Use nano (nano-banana-2) for flat-vector logos, icons, and mascots since it produces clean linework and on-brand color cheaply. Avoid flux for crisp vector marks because it is a photo-diffusion model that yields soft, painterly output.

How do I control spending when generating images in batches?

Pass --cap with a dollar amount on every run. On batch and compare commands the cap acts as a circuit breaker that skips shots exceeding the budget without charging, and resume finishes them later once the cap is raised.

Can I generate images in a consistent style across a set?

Yes, use the style command with --refs pointing to a folder of reference images, supported on the nano and gpt models. A per-project .forge/brand.json profile also folds palette and style rules into every prompt automatically.

What happens if an image generation run is interrupted?

Run resume with the run-id to continue. It re-polls in-flight jobs without paying twice and re-submits only generations that truly failed, reading state from the run's manifest.json.

When should I not use Fal.ai image generation for game art?

Do not use it for pixel-art game sprites and animations; that work belongs to PixelLab. This workflow targets illustration, photoreal, marketing, and concept imagery rather than pixel art.