Agent skill

Image Gen Guide

by ZS520L in ZS520L/HanakoPro

“使用图片/视频生成工具时必读。包含工具参数、非阻塞工作流、任务路由。”

— description from SKILL.md by ZS520L
Apache-2.0Auto-check passedMedia & Creative

Install Image Gen Guide

skills CLI
$ npx skills add ZS520L/HanakoPro --skill image-gen-guide -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZS520L/HanakoPro image-gen-guide --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZS520L/HanakoPro.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/image-gen/skills/image-gen-guide .claude/skills/image-gen-guide && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
image-gen-guide
GitHub stars
103
Token cost
~381 tokens
SKILL.md length
116 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

  • Works in 4 steps: 调用工具,传入 prompt 和参数 → 告诉用户正在生成,完成后会自动显示在卡片中 → 继续对话,不要等待 → …
  • SKILL.md covers 非阻塞工作流, 工具参数, 任务路由 and 注意
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

About this skill

Image Gen Guide is a skill in ZS520L/HanakoPro (103 stars). Its SKILL.md is about 381 tokens. Licence: Apache-2.0.

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 调用工具,传入 prompt 和参数
  2. 告诉用户正在生成,完成后会自动显示在卡片中
  3. 继续对话,不要等待
  4. 收到 通知时,自然地告知用户结果

What it can do on your machine

Read from SKILL.md and the folder at commit 49ec8dc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Image Gen Guide loads about 381 tokens when it runs. Until then it costs about 13 tokens; SKILL.md has 116 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~13
When it runs · the whole SKILL.md, loaded when a task matches
~381

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZS520L/HanakoPro at commit 49ec8dc, republished under its Apache-2.0 licence (© ZS520L). 116 words, ~381 tokens.

Download SKILL.mdSave it as .claude/skills/image-gen-guide/SKILL.md (or your agent's skills folder).
name
image-gen-guide
description
使用图片/视频生成工具时必读。包含工具参数、非阻塞工作流、任务路由。

媒体生成工具指南

非阻塞工作流

生成是异步的。提交后工具立即返回一张卡片,你不需要等待结果,也不需要调用 stage_files。图片/视频文件由 image-gen 插件在后台完成时登记为 SessionFile;卡片只呈现任务状态和结果引用,文件生命周期仍归 StageFile 管。

  1. 调用工具,传入 prompt 和参数
  2. 告诉用户正在生成,完成后会自动显示在卡片中
  3. 继续对话,不要等待
  4. 收到 <hana-background-result> 通知时,自然地告知用户结果

工具参数

image-gen_generate-image
  • prompt(必填):图片描述,中英文均可
  • count:并发生成张数(1-9),用户说"多来几张"/"再抽几张"时用
  • image:参考图路径(图生图、图片编辑、风格迁移时传入)
  • ratio:长宽比(1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9)
  • resolution:分辨率(2k, 4k)
  • quality:画质(low, medium, high)
  • provider:指定生图 provider(可选,默认自动选择)。可用 provider 来自 Hana Provider Registry 的 media.imageGeneration capability,不从聊天模型列表推断
image-gen_generate-video
  • prompt(必填):视频描述,中英文均可
  • image:参考图路径(图生视频)
  • duration:时长(秒)
  • ratio:长宽比
  • provider:指定 provider(可选)

任务路由

用户意图示例工具备注
凭空生成图片"画一只猫"generate-imageprompt 描述画面
编辑/修改图片"把帽子去掉"generate-image + image 参数prompt 写编辑指令
参考图生新图"参考这个风格画一套icon"generate-image + image 参数prompt 说明参考什么 + 要生成什么
生成视频"做一个猫的短视频"generate-videoprompt 描述画面和运动
图片变视频"让这张图动起来"generate-video + image 参数prompt 描述运动和变化
不是生成请求"这张图画的是什么"不调用只是看图/聊天

注意

  • 生成消耗 provider 额度,大批量前建议提醒用户
  • 不同 provider 支持的参数不同,工具会按 provider 的媒体能力和 adapter 处理
  • Provider 可能来自内置 provider、插件贡献,或 CLI wrapper。不要假设它一定是聊天 provider
  • 视频生成通常比图片慢(几十秒到几分钟),但同样不阻塞
  • 图中需要出现文字时,把文字内容放在双引号里

© ZS520L, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/image-gen/skills/image-gen-guide of ZS520L/HanakoPro.

Open the folder on GitHubat commit 49ec8dc

Compare with similar skills

Image Gen Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Image Gen Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Image Gen Guide this skillZS520L/HanakoPro103—~381Automated safety check: PassApache-2.0
AI Image Generation and Editingzhayujie/CowAgent47k—~1.3kAutomated safety check: PassMIT
Structured Image Generationbytedance/deer-flow84k4 repos~2.9kAutomated safety check: PassMIT
Canghe Comicfreestylefly/canghe-skills4618 repos~3.2kAutomated safety check: PassNone
Generate Imageynulihao/AgentSkillOS61810 repos~1.7kAutomated safety check: NotesNone
GPT Image Generation CLIwuyoscar/GPT-Image2-Skill5.7k—~2.5kAutomated safety check: NotesMIT

Similar skills

  • Generates or edits images from text prompts through a Python script that picks an image backend based on which API keys are configured.

    47k GitHub stars~1.3k tokensUpdated today
    Media & CreativeAuto-check passed
  • Structured Image Generation

    bytedance/deer-flow

    Turns an image request into a structured JSON prompt and runs a bundled Python script to generate the picture, optionally guided by reference images.

    84k GitHub starsUsed in 4 repos~2.9k tokens
    Media & CreativeAuto-check passed
  • Canghe Comic

    freestylefly/canghe-skills

    Knowledge comic creator supporting multiple art styles and tones.

    461 GitHub starsUsed in 8 repos~3.2k tokens
    Media & CreativeAuto-check passed
  • Generate Image

    ynulihao/AgentSkillOS

    Generate or edit images using AI models (FLUX, Gemini). An agent skill from ynulihao/AgentSkillOS.

    618 GitHub starsUsed in 10 repos~1.7k tokens
    Media & CreativeAuto-check: notes
  • GPT Image Generation CLI

    wuyoscar/GPT-Image2-Skill

    Generates and edits images with GPT Image 2 or 2.5 through a packaged CLI and a prompt gallery, after settling which model fits the request.

    5.7k GitHub stars~2.5k tokensUpdated 10 days ago
    Media & CreativeAuto-check: notes
  • Minimal Zine Poster Generator

    LiamGvchi/gc-minimal-zine-poster

    Creates or analyzes quiet, paper-texture zine posters with big negative space, one color accent and experimental type, returning an image prompt and the generated poster.

    7.3k GitHub stars~2.9k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed

More from ZS520L/HanakoPro

  • Office Documents

    ZS520L/HanakoPro

    A skill your agent uses when the user asks to open, read, inspect, understand, summarize, analyze, extract tables/text from, modify, update, repair, split, merge, rotate, or convert information from…

    103 GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Research Platform

    ZS520L/HanakoPro

    全自动科研平台:从论文检索、知识图谱构建、研究缺口分析、假设生成,到实验执行、论文写作、自审修正的完整科研流水线。Agent 按此 Skill 的指令自主推进研究流程。触发场景:做研究、搜论文、找研究缺口、生成假设、跑实验、写论文、文献综述、benchmark对比 / Triggers: research, literature review, paper search, hypothesis…

    103 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Hana Plugin Creator

    ZS520L/HanakoPro

    Create Hana plugin scaffolds and guide users through beginner or developer plugin planning, capability checks, manifest setup, runtime tools, iframe UI, SDK templates, and install-ready plugin…

    103 GitHub stars~2.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Skill Creator

    ZS520L/HanakoPro

    Create new skills, modify and improve existing skills, and measure skill performance.

    103 GitHub stars~7.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Quiet Musing

    ZS520L/HanakoPro

    Deep reasoning framework for complex tasks. An agent skill from ZS520L/HanakoPro.

    103 GitHub stars~574 tokensUpdated 4 mo ago
    Auto-check passed
  • User Guide

    ZS520L/HanakoPro

    Hanako 用户说明书。解答用户关于软件使用方法、功能介绍、常见问题和实用技巧的疑问. An agent skill from ZS520L/HanakoPro.

    103 GitHub stars~2.8k tokensUpdated 4 mo ago
    Auto-check: warnings

Questions about Image Gen Guide

How do I install Image Gen Guide in Claude Code?

Run `npx skills add ZS520L/HanakoPro --skill image-gen-guide -a claude-code`. Or copy the skill folder (plugins/image-gen/skills/image-gen-guide in ZS520L/HanakoPro) into .claude/skills/image-gen-guide in your project. Claude Code loads it when a task matches its description.

How do I install Image Gen Guide in Codex?

Run `npx skills add ZS520L/HanakoPro --skill image-gen-guide -a codex`. Or copy the skill folder (plugins/image-gen/skills/image-gen-guide in ZS520L/HanakoPro) into .agents/skills/image-gen-guide in your project. Codex loads it when a task matches its description.

Can I use Image Gen Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZS520L/HanakoPro --skill image-gen-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/image-gen-guide, .gemini/skills/image-gen-guide, .github/skills/image-gen-guide and .opencode/skills/image-gen-guide in your project.

What does Image Gen Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Image Gen Guide is instructions for the agent only.

Does Image Gen Guide access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Image Gen Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Image Gen Guide use?

Image Gen Guide is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Image Gen Guide use?

About 381 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Image Gen Guide?

Skills that share tags, products or a category with Image Gen Guide: AI Image Generation and Editing (zhayujie/CowAgent, 47k stars), Structured Image Generation (bytedance/deer-flow, 84k stars), Canghe Comic (freestylefly/canghe-skills, 461 stars) and Generate Image (ynulihao/AgentSkillOS, 618 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Image Gen Guide?

ZS520L (a GitHub user) maintains it in ZS520L/HanakoPro, which has 103 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on May 31, 2026.

Source: ZS520L/HanakoPro on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.