cf-image
Skill87 starsChanged 4 months agoMITView on GitHub
Generate an image from a text description using Cloudflare Workers AI (the flux-1-schnell model). Use this skill whenever the user wants to create, generate, make, or draw an image / picture / logo / icon / thumbnail / wallpaper / banner from a text idea and mentions Cloudflare, or is working in this repo and asks for a quick generated image. Claude expands the user's request into a strong image prompt, runs the bundled generate.py, and saves a JPG to disk. Trigger on phrases like "generate an image of", "make me a picture of", "create a thumbnail for", "cloudflare image", or a plain description paired with a request for an image. Requires CF_ACCOUNT_ID and CF_API_TOKEN in the project's .env.
- Reads credentials
In this repository7 other files it gives its agents.
- prompt-to-designSkill
- 3d-image-rendererSkill
- scene-splitterSkill
- storybook-pipelineSkill
- story-html-publisherSkill
- story-illustratorSkill
- story-narratorSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 44
Keep prompts to one or two sentences.
- Very specific: line 50
If they want variations, re-run with a modified prompt and a new -o filename.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
cf-image
Turn a natural-language request into a generated image using Cloudflare Workers AI (@cf/black-forest-labs/flux-1-schnell). This skill is the "connect Claude to image generation" loop: the user describes what they want, Claude does the prompt engineering, the bundled script calls the Cloudflare API, and the image is saved locally.
When this skill applies
The user wants an image generated from a description — e.g. "generate a logo idea for a coffee shop", "make a thumbnail for my AI video", "picture of a cyberpunk cat". Claude is responsible for turning a vague ask into a good prompt before generating.
It does not apply to: editing an existing image, vector/SVG art, or video.
How to run it
From the repo root:
python .claude/skills/level-3-image-generator/generate.py "<optimized prompt>" -o <filename>.jpg"<optimized prompt>"— the prompt you write (see below), not the user's raw words.-o/--output— where to save (defaultout.jpg). Pick a short descriptive name, e.g.coffee-logo.jpg.--steps— diffusion steps (default4). flux-schnell is tuned for few steps; 4–8 is plenty. Higher is slower, not always better.
The script prints Saved <file> ... on success, or a Cloudflare API error message on failure.
The one job Claude must do: write a strong prompt
The raw script would need a hand-written prompt. The value of this skill is that Claude expands the user's intent into a vivid, specific prompt before calling the script. A good Flux prompt names:
- Subject — what's in the frame, concretely.
- Style/medium — photo, 3D render, flat vector, watercolor, isometric, etc.
- Composition & framing — close-up, wide shot, centered, rule-of-thirds.
- Lighting & mood — golden hour, neon, soft studio light, dramatic shadows.
- Color/detail cues — palette, background, level of detail.
Example transformation:
- User: "a logo for a coffee shop"
- Prompt you pass: "minimalist logo of a steaming coffee cup, flat vector illustration, warm brown and cream palette, centered on a clean off-white background, simple bold shapes, modern branding"
Keep prompts to one or two sentences. Don't include text/words to render — Flux is unreliable at rendering legible text.
After generating
- Confirm the file was saved (the script prints the path).
- Tell the user the filename and the exact prompt you used, so they can tweak and re-run.
- If they want variations, re-run with a modified prompt and a new
-ofilename.
Requirements
CF_ACCOUNT_IDandCF_API_TOKENset in the project's.env(see.env.example). The script loads them automatically.- Python deps:
requests,python-dotenv.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

