AgentSkillsCN

gemini

利用Google Gemini API生成图像。当用户请求生成、创作或制作图像、图片、照片，或各类视觉内容时，可使用本技能。同样适用于图像编辑、图像到图像的生成，以及任何基于AI的图像创作需求。

SKILL.md
--- frontmatter
name: gemini
description: Generate images using Google Gemini API. Use when user asks to generate, create, or make images, pictures, photos, or visual content. Also for editing images, image-to-image generation, or any AI image creation requests.
argument-hint: "[prompt description or 'interactive' for guided mode]"
allowed-tools: Bash, Write, Read, Glob, AskUserQuestion

Gemini Image Generation

Generate high-quality AI images using Google's Gemini API.

Before First Use

Run the setup check to validate environment:

bash
"${CLAUDE_PLUGIN_ROOT}/skills/gemini/scripts/check-setup.sh"

This validates Python, venv, dependencies, API key, and shows existing images.

Generation

bash
SCRIPT_DIR="${CLAUDE_PLUGIN_ROOT}/skills/gemini/scripts"
"$SCRIPT_DIR/generate.sh" "your detailed prompt" \
  --aspect-ratio 16:9 \
  --resolution 4K \
  --output images/slug-v1/image.png \
  --user-request "user's original request verbatim" \
  --composition "your reasoning: why you chose this style, composition, colors, etc."

Options:

  • •--aspect-ratio: 1:1, 3:4, 4:3, 2:3, 3:2, 16:9, 9:16, 21:9, 9:21, 32:9, 2:1 (default: 1:1)
  • •--resolution: 1K, 2K, 4K (default: 2K)
  • •--output: Output filename (default: output.png)
  • •--fast: Use faster model (lower quality)
  • •--images: Reference image(s) for editing/fusion
  • •--user-request: Original user request (ALWAYS pass this)
  • •--composition: Your reasoning/composition notes explaining prompt choices (ALWAYS pass this)
  • •--no-metadata: Skip saving metadata YAML file

Output: The script saves {image_name}_metadata.yaml alongside the image containing: user request, composition reasoning, final prompt, all parameters, token usage, timestamps, and model response.

Invocation Modes

Interactive (no prompt or vague prompt): Use AskUserQuestion to gather subject, style, aspect ratio, quality.

Direct (detailed prompt provided): Execute immediately with sensible defaults.

Programmatic (called from workflow): Never block, use defaults, execute immediately.

Workflow

  1. •Check setup: Run check-setup.sh script (especially on first use or errors)
  2. •Determine mode: Interactive vs direct based on prompt clarity
  3. •Capture user request: Save the user's original request verbatim for --user-request
  4. •Compose prompt: Enhance the request into a detailed prompt, document your reasoning for --composition
  5. •Generate slug: 2-4 word description, lowercase, hyphenated (e.g., sunset-mountains)
  6. •Check existing: Look for images/{slug}-v* folders for iterations
  7. •Generate: Run script with ALL context flags (--user-request, --composition)
  8. •Report: Show user the result location and version (metadata auto-saved as image_metadata.yaml)

Interactive Questions (when prompt is vague)

When the user's request lacks detail, use AskUserQuestion to gather:

  • •Subject: Person/Portrait, Product, Landscape/Scene, or Abstract/Artistic
  • •Purpose: Final/Production (4K), Testing/Draft (fast mode), or Web/Social (2K)
  • •Style details: Lighting, colors, mood if relevant

Iteration Detection

User wants iteration when they say: "another version", "adjust", "modify", "change", "try with", "regenerate".

Find latest version, increment, archive previous in archive/v{N}/.

Reference

For detailed setup, troubleshooting, prompt engineering, and file templates, see SETUP.md.