@kolbo/kolbo-code-linux-arm64-musl 0.0.0-dev-202604161628

package/skills/image-prompting-guide/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: image-prompting-guide
+description: >
+  Deep image generation prompting guide: visual consistency strategies, hero reference technique,
+  FLUX resolution rules, batch generation, style-specific prompt patterns, prompt construction
+  with contextual layers. Complements the kolbo skill's image section with production-grade
+  techniques.
+  Keywords: image prompt, flux, dall-e, image generation, consistency, visual style, hero image,
+  reference, batch, resolution, prompt engineering, style, photorealistic, illustration
+---
+
+# Image Generation — Production Prompting Guide
+
+This skill extends the `kolbo` skill's image prompting rules with production-grade techniques for maintaining visual consistency across multiple images.
+
+## Resolution for Video Frames
+
+When generating images for use as video frames:
+
+| Target | Recommended Resolution | Notes |
+|--------|----------------------|-------|
+| YouTube 16:9 | 1920x1088 | FLUX requires multiples of 16 |
+| YouTube 4K | 3840x2160 | Premium models only |
+| TikTok/Reels 9:16 | 1088x1920 | FLUX multiples of 16 |
+| Square 1:1 | 1024x1024 | Standard |
+| Thumbnail | 1280x720 | |
+
+## Maintaining Visual Consistency
+
+The biggest challenge: making 8-12 generated images look like they belong in the same video.
+
+### Strategy 1 — Shared Visual System (Always Use)
+
+Define a shared visual system for the project first:
+- Dominant mood and texture
+- Palette direction (3-5 anchor colors)
+- Lighting bias
+- Rendering medium
+- Character/environment consistency anchors
+
+**Don't paste the same style description verbatim into every prompt.** Distill it into a shorter scene-appropriate anchor. Verbatim repetition makes all scenes look identical.
+
+### Strategy 2 — Hero Reference Image (Recommended)
+
+1. Generate one "hero" image at maximum quality
+2. Use it as reference for all subsequent frames
+3. In Kolbo: use Visual DNA profiles or pass the hero image URL as reference
+
+```
+Frame 1: Text-to-image with detailed prompt → hero.png
+Frame 2: Image-to-image with hero as reference + "Same style, camera pans right..."
+Frame 3: Image-to-image with hero as reference + "Same style, zoomed in on..."
+```
+
+### Strategy 3 — Seed Locking
+
+Use the same seed parameter across generations with similar prompts. Produces similar compositions but fragile to prompt changes — supplement, not primary strategy.
+
+## Prompt Construction — 3-Part Approach
+
+### Part 1: Scene-Specific Style Direction
+From the shot's camera and lighting needs:
+```
+[SHOT SIZE, e.g., "medium close-up"].
+[LIGHTING, e.g., "golden hour warm light"].
+[DEPTH, e.g., "shallow depth of field with bokeh"].
+[TEXTURE, e.g., "film grain, warm tones"].
+```
+
+### Part 2: Visual Consistency Anchor (adapted, not verbatim)
+Extract the ESSENCE of the project's visual language:
+- Full description: "Clean, minimal illustration with soft shadows, muted color palette"
+- Adapted anchor: "muted color palette, soft shadows"
+
+### Part 3: Scene Description
+The actual content. Be specific — replace generic words with concrete details.
+
+**BAD:** "A person using a computer in a modern office"
+**GOOD:** "Software developer in a dimly lit home office, blue monitor glow reflecting off glasses, desk cluttered with energy drinks and sticky notes"
+
+### Full Prompt Example
+```
+Medium close-up, golden hour warm lighting, shallow depth of field.
+Muted earth tones, soft shadows.
+Beekeeper in white protective gear lifting a frame dripping with honey,
+late afternoon sun catching golden droplets, lavender field blurred
+in the background. Film grain, warm amber tones.
+16:9 aspect ratio.
+```
+
+## Style-Specific Prompt Patterns
+
+| Style | Prompt Pattern |
+|-------|---------------|
+| **Flat illustration** | "Flat vector illustration, bold colors, clean edges, no gradients, white background" |
+| **Isometric** | "Isometric 3D illustration, 30-degree angle, clean geometric shapes, soft shadows" |
+| **Photorealistic** | "Photorealistic, shot on Canon EOS R5 with 85mm f/1.4, shallow depth of field" |
+| **Diagram-style** | "Technical diagram, labeled components, clean lines, minimal color, white background" |
+| **Watercolor** | "Soft watercolor illustration, muted tones, visible brush strokes, paper texture" |
+
+## Batch Generation Strategy
+
+| Phase | Quality | Purpose |
+|-------|---------|---------|
+| 1. Style guide | Maximum | One hero image, establish the look |
+| 2. Storyboard iteration | Fast/cheap model | Rapid variations during planning |
+| 3. Final frames | High quality | Re-generate finals with hero as reference |
+
+## Common Pitfalls
+
+1. **Text in images** — AI generators are unreliable with text. Add text as overlays in post
+2. **Hands and fingers** — Still problematic. Avoid prompts requiring detailed hand poses
+3. **Inconsistent characters** — Without references, same character looks different each time. Use Visual DNA
+4. **Over-prompting** — Long, complex prompts produce unpredictable results. Keep to 2-3 sentences
+5. **Over-unifying prompts** — Same style phrase in every prompt makes scenes samey. Let each scene express its own subject and mood within the visual system
+
+---
+
+## Kolbo MCP Integration
+
+| Task | Kolbo MCP Tool | Notes |
+|------|---------------|-------|
+| Text-to-image | `generate_image` | Apply 3-part prompt construction above |
+| Image editing | `generate_image_edit` | Describe the CHANGE, not the whole image |
+| Multi-scene batch | `generate_creative_director` | 1-8 coordinated scenes, one brief |
+| Style consistency | `create_visual_dna` type="style" | Create from reference images |
+| Character consistency | `create_visual_dna` type="character" | Max 4 reference images |
+| Discover models | `list_models` type="image" | Always check before generating |
+| Style templates | `list_moodboards` / `get_moodboard` | Pre-made style directions |
+
+**Workflow for consistent image sets:**
+1. `create_visual_dna` with 2-4 reference images → get `visual_dna_id`
+2. Generate hero image: `generate_image` + `visual_dna_ids` + detailed prompt
+3. Generate remaining frames: same `visual_dna_ids` + adapted prompts per scene
+4. Or use `generate_creative_director` for automatic multi-scene coordination
+
+---
+
+## Local / Free Option
+
+> **IMPORTANT:** Always use Kolbo MCP tools by default. Only suggest local alternatives if the user explicitly asks about free/offline options. Always confirm before installing anything on the user's machine.
+
+If the user has a GPU (8GB+ VRAM) and wants local image generation, recommend **ComfyUI** with Stable Diffusion XL or FLUX.1 dev. For background removal without credits, `rembg` is a simple pip install that works on CPU.