image-generator

Generates images using GPT Image 1.5 API. Use when users request image creation, illustration, or visual content.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 3, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill enables seamless AI image generation powered by the GPT Image 1.5 API. It empowers users to transform text descriptions into high-quality visual assets, including illustrations, diagrams, and artwork, with granular control over aspect ratios and output quality to enhance creative productivity.

Use Cases

  • Content Creation: Generate custom illustrations and high-resolution images for blog posts, social media, and marketing materials to increase audience engagement.
  • Design Prototyping: Rapidly visualize concepts, mood boards, and character designs during the brainstorming phase of creative projects.
  • Technical Documentation: Create visual aids and diagrams to simplify complex concepts in technical guides, presentations, or educational resources.
  • Marketing Assets: Produce professional-grade landscape or portrait visuals for landing pages and digital advertisements using specific quality presets.
nameimage-generator
descriptionGenerates images using GPT Image 1.5 API. Use when users request image creation, illustration, or visual content.

Image Generation Skill

Generate images using GPT Image 1.5 when users request visual content.

When to Use

Use this skill when users:

  • Ask to "create", "generate", "draw", or "make" an image
  • Request illustrations, artwork, diagrams, or visual content
  • Want to visualize concepts, ideas, or descriptions

How to Generate Images

Use the telclaude generate-image CLI command. This handles API key retrieval from keychain, rate limiting, and proper error handling.

# Basic usage - generates image and outputs file path
telclaude generate-image "YOUR_PROMPT_HERE"

# With size option (default: 1024x1024)
telclaude generate-image "YOUR_PROMPT" --size 1536x1024

# With quality option (default: medium)
telclaude generate-image "YOUR_PROMPT" --quality high

Options:

  • --size: "1024x1024" (square), "1536x1024" (landscape), "1024x1536" (portrait)
  • --quality: "low" (fast/cheap), "medium" (balanced), "high" (best quality)

Example

To generate a landscape sunset image:

telclaude generate-image "A serene mountain landscape at sunset with a lake reflection" --size 1536x1024 --quality high

The command outputs:

Generated image saved to: /path/to/generated-image.png
Size: 1234.5 KB
Model: gpt-image-1.5

Response Format

After running the command, include the full file path in your response. The telclaude relay automatically detects paths to generated media and sends the file to the user via Telegram.

Example response:

I've generated your image and saved it to:
/media/outbox/generated/1234567890-abc123.png

[The relay will automatically send the image to you]

Important:

  • Always include the full path from the command output in your response
  • The relay detects paths under TELCLAUDE_MEDIA_OUTBOX_DIR (default .telclaude-media in native mode; /media/outbox in Docker) and sends them automatically
  • No additional commands are needed - just include the path

Best Practices

  1. Be Descriptive: Include details about style, mood, colors, composition
  2. Specify Style: Mention if you want photorealistic, illustration, cartoon, etc.
  3. Avoid Prohibited Content: No copyrighted characters, real people, or inappropriate content
  4. Use Quality Wisely: "low" for drafts, "high" for final images

Rate Limits

  • Maximum 10 images per hour per user
  • Maximum 50 images per day per user
  • Images are stored temporarily and cleaned up after 24 hours

Error Handling

If you get "Image generation not available", the user needs to run telclaude setup-openai to configure their API key.