agentleFS
Galbaz1Galbaz1/video-research-mcp/skills/image-generation/SKILL.md

image-generation

Skill23 starsChanged 38 days agoMITView on GitHub

Enhances image generation prompts with Subject-Context-Style structure, style anchors, character consistency, and reference-based editing. Not for video generation, TTS, FFmpeg, audio, or design-to-code.

63 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use gift-evaluator, Podcast Generate 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.
  • 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

  • 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

  • +1 more from huang-x-h
  • +7 more from dav-niu474

The file

Show its rules and text

We split this skill into the rules it gives an agent

15 rules. 0 are common, 15 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 54 edited versions we read keep these.

  • 15

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Add concrete visual details where the user left gaps:

    line 51
  2. Distinctive:

    When a photographic look is appropriate:

    line 60
  3. Distinctive:

    When the image should contain readable text (signs, labels, titles, typography):

    line 77
  4. Distinctive:

    When the same character must be recognizable across multiple images:

    line 87
  5. Distinctive:

    Use anchoring words: "distinctive", "signature", "always wears", "always has"

    line 90
  6. Distinctive:

    Use the active provider's reference-image field to edit the base character image.

    line 92
  7. Distinctive:

    When combining multiple visual elements in one scene:

    line 96
  8. Distinctive:

    Use integration language: "seamlessly blending", "harmoniously composed", "naturally integrated"

    line 99
  9. Distinctive:

    When depicting real places, cultures, or historical elements:

    line 104
  10. Distinctive:

    Use specific terminology: "traditional Edo-period architecture", "authentic Moroccan zellige tilework"

    line 106
  11. Distinctive:

    When generating images that will serve as style references for AI video production:

    line 125
  12. Distinctive:

    Inspect before reuse: verify lighting, texture, composition, and identity.

    line 129
  13. Distinctive:

    Match video prompt lighting: use the exact same physical light source description in the image prompt that will appear in the video prompt …

    line 131
  14. Distinctive:

    When modifying an existing image:

    line 135
  15. Distinctive:

    Use anchoring phrases: "maintain the existing...", "preserve the original...", "keep the same..."

    line 138

“Common” is measured: kept by at least 6 in 10 of the 54 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 Prompt Best Practices

This plugin does not bundle an image-generation tool. Discover the active provider, inspect its schema, and confirm spend/attempt limits before requesting images. Provider-specific parameter names such as inputImagePath are not portable.

Verified on 2026-09-29: Google documents gemini-3.1-flash-image for general generation/editing, gemini-3.1-flash-lite-image for inexpensive 1K work, and gemini-3-pro-image for complex design. See official image guidance for exact API, supported references, sizes, and pricing; use the provider available to the session.

Prompt Structure

Enhance every image generation prompt around three core elements:

1. SUBJECT (What)

The main focus of the image.

  • Physical characteristics: textures, materials, colors, scale
  • Actions, poses, expressions if applicable
  • Distinctive features that define the subject

2. CONTEXT (Where/When)

The environment and conditions.

  • Setting, background, spatial relationships (foreground, midground, background)
  • Time of day, weather, atmospheric conditions
  • Mood and emotional tone of the scene

3. STYLE (How)

The visual treatment.

  • Artistic or photographic approach: reference specific artists, movements, or styles
  • Lighting design: direction, quality, color temperature, shadows
  • Camera/lens choices: specify focal length, aperture, and shooting angle when photographic

Core Principles

  • Preserve intent -- Enrich the user's original vision, never override it
  • Preserve constraints -- Describe desired elements positively and retain explicit exclusions using supported instructions or a negative-prompt field
  • Specific over vague -- "golden hour sunlight at 15 degree angle" beats "nice lighting"
  • Natural flow -- Weave elements into a single flowing description, not a bullet list

Enhancement Patterns

Hyper-Specific Details

Add concrete visual details where the user left gaps:

  • Lighting: direction, quality, color temperature, shadow behavior. Always name the physical source ("warm afternoon sun through west window", not "warm lighting") -- named sources produce consistent shadows
  • Textures: surface materials, weathering, reflectivity
  • Atmosphere: particulates, humidity, depth haze
  • Scale: relative sizes, distances, proportions

Camera Control Terminology

When a photographic look is appropriate:

  • Lens type: "shot with 85mm portrait lens", "wide-angle 24mm"
  • Aperture: "shallow depth of field at f/1.8", "deep focus at f/11"
  • Angle: "low angle emphasizing height", "bird's eye view"
  • Motion: "motion blur on the paws", "frozen mid-action"

Atmospheric Enhancement

Convey mood through environmental details:

  • Emotional tone: "serene", "ominous", "jubilant"
  • Light quality: "dappled shadows", "harsh midday sun", "soft diffused overcast"
  • Weather/air: "morning mist", "dust particles in a sunbeam"

Text in Images

When the image should contain readable text (signs, labels, titles, typography):

  • Specify the exact text content in quotes: "OPEN 24 HOURS" in bold sans-serif
  • Describe visual treatment: font style, weight, size relative to the scene
  • Define placement and integration: "centered on the storefront awning", "hand-lettered on the chalkboard"

Feature Patterns

Character Consistency

When the same character must be recognizable across multiple images:

  • Include at least 3 recognizable visual markers (distinctive scar, signature clothing, unique hairstyle, characteristic accessory)
  • Use anchoring words: "distinctive", "signature", "always wears", "always has"
  • Be specific: "round tortoiseshell glasses" not just "glasses"
  • Use the active provider's reference-image field to edit the base character image; inspect the resulting markers before using it as a reference

Compositional Integration (Multi-Element Blending)

When combining multiple visual elements in one scene:

  • Define spatial relationships with proportions: "foreground (40% of frame)", "midground", "background"
  • Use integration language: "seamlessly blending", "harmoniously composed", "naturally integrated"
  • Specify relative scale and interaction between elements

Real-World Accuracy

When depicting real places, cultures, or historical elements:

  • Use specific terminology: "traditional Edo-period architecture", "authentic Moroccan zellige tilework"
  • Include culturally accurate details
  • Reference geographical or historical specifics

Purpose-Driven Enhancement

Tailor the prompt to the intended use:

PurposeEmphasis
Product photoClean background, studio lighting, commercial appeal
UI mockupFlat design elements, consistent spacing, screen-appropriate
Presentation slideBold composition, clear focal point, text-friendly layout
Social mediaEye-catching, vibrant, crop-friendly aspect ratio
Book/album coverTypography space, dramatic mood, symbolic elements
Video style anchorSupported resolution sufficient for delivery, named physical light source, required surface/identity details, and inspected composition. Reuse the accepted reference downstream

Video Style Anchor Pipeline

When generating images that will serve as style references for AI video production:

  1. Match delivery needs: choose a supported size that preserves the required details; use 4K only when its added cost serves the output
  2. Character consistency: maintain character consistency when generating multiple hero images for the same scene or character
  3. Inspect before reuse: verify lighting, texture, composition, and identity; allow one targeted repair within the authorized budget
  4. Blend for composites: combine reference photography with branded elements when building composite anchors
  5. Match video prompt lighting: use the exact same physical light source description in the image prompt that will appear in the video prompt -- shadow direction must be consistent across the chain

Image Editing

When modifying an existing image:

  • Preserve the original's core characteristics: color palette, lighting style, composition
  • Use anchoring phrases: "maintain the existing...", "preserve the original...", "keep the same..."
  • Be specific about what to change vs what to keep unchanged
  • Describe modifications relative to the existing image, not from scratch

Example

Input: "A happy dog in a park"

Enhanced: "Golden retriever mid-leap catching a red frisbee, ears flying, tongue out in joy, in a sunlit urban park. Soft morning light filtering through oak trees creates dappled shadows on emerald grass. Background shows families on picnic blankets, slightly out of focus. Shot from low angle emphasizing the dog's athletic movement, with motion blur on the paws suggesting speed."

Completion

Inspect the actual image at full resolution for subject fidelity, text, required exclusions, and editing boundaries. Return its path, provider/model, reference provenance, and unresolved defects. A successful tool response or a larger requested resolution does not prove the image meets the brief.

Download now (ZIP)

Does it work?

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

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

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.