CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-image-gpt-image-fal

Generate a single photoreal or designed image with OpenAI gpt-image via fal.ai. Supports gpt-image-1 (default, fixed sizes — the FAL fallback for Higgsfield's `gpt_image_2`) and gpt-image-2 (`openai/gpt-image-2`, custom output sizes up to 3840px). Routes to text-to-image or the edit variant depending on whether a reference image is provided. Use for photoreal character anchors, scene keyframes, and designed sheets (e.g. storyboards) where precise layout and legible text matter.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Highly actionable, well-structured operational content with executable commands, explicit validation checks, and a thorough troubleshooting table. The main costs are repetition of the proxy/credentials story across sections and inline detail that could be split into reference files.

Suggestions

Consolidate the proxy/credentials explanation into one section (or the Failure Modes table only) — 'bills the Ads agent', 'does not upload local files', and the FAL_API_KEY warning each currently appear 3-4 times.

Move the Model notes and Cross-provider parity note into a short reference file (e.g. references/model-notes.md) and link to it, keeping SKILL.md as a tighter overview.

Use the full script path in all three Workflow examples instead of switching from the full path to '.../generate.py'.

DimensionReasoningScore

Conciseness

Nearly every line carries non-obvious operational fact (proxy routing, public-URL requirement, multiples-of-16 sizing, host-swapping queue URLs) rather than concepts Claude already knows. Not level 5 because the proxy/credentials story is restated in four places — Inputs ("bills the Ads agent"), "Credentials at run time", Workflow step 1, and the Failure Modes 401 row — and "The proxy does not upload local files" appears three times; consolidating would trim tokens without losing anything.

4 / 5

Actionability

Fully executable: three copy-paste bash invocations with real flags and values ("--ref-image \"https://.../anchor.png\"", "--image-size 1728x2304"), a Failure Modes table mapping exact symptoms to exact fixes ("Drop concurrency to 2-3"), and concrete prompt advice ("natural skin texture with pores, slight asymmetry"). Common cases are covered; the only shortcut is ".../generate.py" in two examples, which is unambiguous given the first example spells out the full path.

5 / 5

Workflow Clarity

The user workflow is unambiguous (run the command with the right flags), the script's behavior is laid out as a clear 6-step sequence, and validation is explicit in Quality Checks: "Output file exists and is > 1 KB", "confirm the output dimensions match the requested WIDTHxHEIGHT", and a Failure Modes table that provides error→fix feedback loops. Not level 4 because checkpoints are explicit and recovery paths are given, not implied.

5 / 5

Progressive Disclosure

Well-organized sections with one-level-deep, real references: the bundle's scripts are correctly cited and characterized (media_proxy.py as the active helper, fal_helpers.py as "LEGACY... kept for reference only" — verified against the actual files), plus external model pages and a signaled pointer to sibling skills ("Safe zones: see create-image-fal"). Not level 5 because ~127 lines of mixed operational detail (Model notes, Cross-provider parity note, storyboard-consumer pointers) all live inline in SKILL.md where some could be split into a reference file for easier navigation.

4 / 5

Total

18

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete capabilities, an explicit 'Use for...' trigger clause, and clear differentiation from sibling image-generation skills. The only gap is a few natural synonym/variation trigger terms.

Suggestions

Add one or two common phrasing variations users might say, e.g. 'image generation' or 'PNG', to broaden trigger matching without adding length.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions and capabilities: "Generate a single photoreal or designed image", "Routes to text-to-image or the edit variant depending on whether a reference image is provided", plus concrete model specifics ("fixed sizes", "custom output sizes up to 3840px"). Coverage is comprehensive for a single-purpose generation skill; not level 4 because there are no meaningful gaps — even routing behavior and model-family differences are stated explicitly.

5 / 5

Completeness

The "what" is explicit ("Generate a single photoreal or designed image with OpenAI gpt-image via fal.ai" with model families and routing) and the "when" is an explicit trigger clause: "Use for photoreal character anchors, scene keyframes, and designed sheets (e.g. storyboards) where precise layout and legible text matter." Both are concrete, matching the level-5 anchor exactly; level 4 would require a vaguer 'when'.

5 / 5

Trigger Term Quality

Good natural-term coverage: "photoreal", "image", "character anchors", "scene keyframes", "storyboards", "designed sheets", "gpt-image", "fal.ai" — terms a user in this video/ads pipeline would naturally say. Not level 5 because a few common variations are missing (e.g. "image generation", "PNG", "keyframe image", "edit an image with a reference").

4 / 5

Distinctiveness Conflict Risk

Clear niche: gpt-image generation via fal.ai, explicitly positioned against the sibling Higgsfield path ("the FAL fallback for Higgsfield's gpt_image_2"), with distinct triggers (character anchors, scene keyframes, storyboard sheets). Overlap risk with other image skills is minimal because the model, provider, and use-cases are all pinned; not level 4 since it doesn't merely reduce overlap — it names the exact differentiators.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

gooseworks-ai/goose-skills

Path

skills/ads/capabilities/create-image-gpt-image-fal/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.