agentleFS
Sign inStart free
hyperfx-aihyperfx-ai/marketing-skills/skills/image-generation/SKILL.md

image-generation

Skill107 starsChanged 5 months agoMITView on GitHub

Generate images through the Hyper MCP with the unified `images_generate` tool — text-to-image, image-to-image, and branded ad creatives — choosing the model (gpt-image-2.5-flare, gpt-image-2.5-sunburst, nano-banana, nano-banana-pro, seedream-4.5) per task. Use when the user asks to generate an image, create an ad creative, do an image-to-image edit, render text inside an image, or produce a print-quality poster.

We split this skill into the rules it gives an agent

9 rules. 0 are common, 4 are distinctive, and 5 are very specific to this project.

  • 0

    Common

    Most of the 52 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 5

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Every tool in this skill is named by its canonical tool name.

    line 26
  2. Very specific:

    If a tool is not found: in Hyper chat, find its toolkit id with discover_toolkits and pass it to enable_toolkit.

    line 34
  3. Very specific:

    Image-to-image / brand references: put files in the request: requests=[{"prompt": "Compose into a gift basket", "reference_images": …

    line 48
  4. Distinctive:

    Do not display image URLs — they render automatically in chat.

    line 52
  5. Distinctive:

    If the user gives a website URL and wants on-brand creatives:

    line 72
  6. Very specific:

    Call firecrawl_branding_extract with the URL → returns brand colors, fonts, personality/tone, and saved image files (logo, favicon, …

    line 74
  7. Very specific:

    Write the prompt using the actual hex colors, font names, and tone, and pass the logo file_id in reference_images.

    line 77
  8. Distinctive:

    Do NOT display image URLs to the user — they show automatically in chat.

    line 97
  9. Very specific:

    Use quality="high" for production, "draft"/"standard" while iterating.

    line 100

“Common” is measured: kept by at least 6 in 10 of the 52 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Image Generation

Generate images with the images_generate tool. It handles text-to-image, image-to-image (pass reference_images), and multi-image composition. By default (model="auto") it picks the best model for the request; set model to choose one.

Requirements

This skill assumes the Hyper MCP is connected to your agent so the images_generate tool is available. For brand-consistent ad creative work, Firecrawl must also be configured under your Hyper integrations.

How to run the tools in this skill

Every tool in this skill is named by its canonical tool name. Run it with the call your surface gives you:

SurfaceFind a toolRun it
Hyper chatCall the tool by its name; search_tools(queries=["<provider> <action>"]) shows its parameters<name>(...)
MCP client (Claude, Cursor, Codex, ChatGPT)search("<what you want to do>"), then describe("<name>")call_read("<name>", {...}), call_write or call_destructive: the one that describe names in call_with
Hyper CLIhyperai search "<what you want to do>", then hyperai describe <name>hyperai call <name> --json '{...}'

If a tool is not found: in Hyper chat, find its toolkit id with discover_toolkits and pass it to enable_toolkit. On an MCP client or the CLI, tell the user which integration to connect in Hyper.

Call shape

images_generate(
    requests=[{"id": "ad1", "prompt": "A polished SaaS ad, clean composition"}],
    aspect_ratio="16:9",     # "1:1" (default), "9:16", "16:9", "4:5", "5:4", "2:3", "3:2", "3:4", "4:3", "21:9"
    quality="standard",      # "draft" | "standard" | "high"
    n=1,                      # 1-4 images per request
    model="auto",            # see "Choosing a model" below
)
  • Image-to-image / brand references: put files in the request: requests=[{"prompt": "Compose into a gift basket", "reference_images": ["file1", "file2"]}].
  • Reproducible output: pass seed=....
  • Ground in real-world search: pass use_search=True.
  • Do not display image URLs — they render automatically in chat.

Choosing a model

model="auto" is the right default. Override only when the task clearly calls for a specific model:

Taskmodel
First-pass concepts / quick ad ideation / everyday generationgpt-image-2.5-flare
Precise edits and branded compositions from reference images, production creativegpt-image-2.5-sunburst
Cheap iteration, image-to-image, the widest aspect ratios (adds 1:4, 1:8, 4:1, 8:1)nano-banana
Readable text inside the image (posters, labels, infographics) or search-grounded scenesnano-banana-pro
Product photography, material/fabric fidelity, accurate spatial depthseedream-4.5

See references/image-prompting.md for per-model prompt-writing tips.

Branded / website ad creatives — extract branding first

If the user gives a website URL and wants on-brand creatives:

  1. Call firecrawl_branding_extract with the URL → returns brand colors, fonts, personality/tone, and saved image files (logo, favicon, og_image).
  2. Optionally firecrawl_urls_scrape with formats=["screenshot"] for visual context.
  3. Write the prompt using the actual hex colors, font names, and tone, and pass the logo file_id in reference_images.

The branding result's file field is a JSON data file, NOT an image — never pass it as a reference. Only logo.file_id and images.*.file_id are usable images.

Higher-level workflows

For multi-shot product or marketplace work, prefer the workflow tools — they preserve product identity and return structured results:

  • images_product_photoshoots_create — multi-shot product photography (studio, lifestyle, hero, carousel, ad pack). See references/product-photoshoot.md.
  • images_marketplace_cards_create — marketplace listing image sets (Amazon main + secondary, A+ modules, Shopify). See references/marketplace-cards.md.

Reminders

  • Do NOT display image URLs to the user — they show automatically in chat.
  • Refine vague prompts unless the user wants verbatim generation.
  • Match aspect_ratio to intent (social, print, web).
  • Use quality="high" for production, "draft"/"standard" while iterating.
  • Generated file_ids can be reused as reference_images in later calls.
  • For website brand work, call firecrawl_branding_extract before generating.

Download now (ZIP)

  • Other versions61 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 61

    1. bytedance/deer-flow★ 85ksame name
    2. zhayujie/CowAgent★ 48ksame name
    3. zhayujie/chatgpt-on-wechat★ 48ksame name
    4. Devin-AXIS/iPolloWork★ 7.3ksame name
    5. Devin-AXIS/A2V★ 7ksame name
    6. jjyaoao/HelloAgents★ 3.2ksame name
    7. stophobia/deerflow2.0-enhanced★ 821same name
    8. langchain-ai/design-agent★ 535same name
    9. claude-office-skills/skills★ 433same name
    10. sonichi/sutando★ 396same name

    51 more not listed

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • Used alongsideProjects with it also use Video Generation, VLM and 10 more.

    Other files people use alongside this one.

    Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
    • huang-x-hSkill

      Video Generation

      Implement AI-powered video generation capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to generate videos from text prompts or images, create video content programmatically, or build applications that produce video outputs. Supports asynchronous task management with status polling and result retrieval.

      Also in 6 projects that use this

    • huang-x-hSkill

      VLM

      Implement vision-based AI chat capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to analyze images, describe visual content, or create applications that combine image understanding with conversational AI. Supports image URLs and base64 encoded images for multimodal interactions.

      Also in 6 projects that use this

    • dav-niu474Skill

      gift-evaluator

      The PRIMARY tool for Spring Festival gift analysis and social interaction generation. Use this skill when users upload photos of gifts (alcohol, tea, supplements, etc.) to inquire about their value, authenticity, or how to respond socially. Integrates visual perception, market valuation, and HTML card generation.

      Also in 5 projects that use this

    • dav-niu474Skill

      Podcast Generate

      Generate podcast episodes from user-provided content or by searching the web for specified topics. If user uploads a text file/article, creates a dual-host dialogue podcast (or single-host upon request). If no content is provided, searches the web for information about the user-specified topic and generates a podcast. Duration scales with content size (3-20 minutes, ~240 chars/min). Uses z-ai-web-dev-sdk for LLM script generation and TTS audio synthesis. Outputs both a podcast script (Markdown) and a complete audio file (WAV).

      Also in 5 projects that use this

    • +1 more from huang-x-h
    • +7 more from dav-niu474
  • In this repository31 other files it gives its agents.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

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.

Check your setup, free