[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77WB3D5Y98FMV44ERNVC680":3,"skill-same:01M77WB3D5Y98FMV44ERNVC680":59},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M77WB3D5Y98FMV44ERNVC680","image-utils",null,"Classic image manipulation with Python Pillow - resize, crop, composite, format conversion, watermarks, brightness\u002Fcontrast adjustments, and web optimization. Use this skill when post-processing AI-generated images, preparing images for web delivery, batch processing image directories, creating responsive image variants, or performing any deterministic pixel-level image operation. Works standalone or alongside bria-ai for post-processing generated images.","Jinhong270\u002FAI-Agent","Jinhong270","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F193703602?v=4","01M77SB4J7ATDYATSD7AW4B8XP","01M77SB4JWRQWNGTTR291BHMQP",3,"MIT","https:\u002F\u002Fgithub.com\u002FJinhong270\u002FAI-Agent\u002Fblob\u002Fmain\u002FXiao-Q\u002Fskills\u002Fimage-utils\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: image-utils\ndescription: Classic image manipulation with Python Pillow - resize, crop, composite, format conversion, watermarks, brightness\u002Fcontrast adjustments, and web optimization. Use this skill when post-processing AI-generated images, preparing images for web delivery, batch processing image directories, creating responsive image variants, or performing any deterministic pixel-level image operation. Works standalone or alongside bria-ai for post-processing generated images.\nlicense: MIT\nmetadata:\n  author: Bria AI\n  version: \"1.3.0\"\n---\n\n# Image Utilities\n\nPillow-based utilities for deterministic pixel-level image operations. Use for resize, crop, composite, format conversion, watermarks, and other standard image processing tasks.\n\n## When to Use This Skill\n\n- **Post-processing AI-generated images**: Resize, crop, optimize for web after generation\n- **Format conversion**: PNG ↔ JPEG ↔ WEBP with quality control\n- **Compositing**: Overlay images, paste subjects onto backgrounds\n- **Batch processing**: Resize to multiple sizes, add watermarks\n- **Web optimization**: Compress and resize for fast delivery\n- **Social media preparation**: Crop to platform-specific aspect ratios\n\n## When NOT to Use This Skill — Use `bria-ai` Instead\n\nThis skill handles **deterministic pixel-level operations** only. For any **generative or AI-powered** image work, use the `bria-ai` skill instead:\n\n- **Generating images from text prompts** → use `bria-ai`\n- **AI background removal or replacement** → use `bria-ai`\n- **AI image editing (inpainting, object removal\u002Faddition)** → use `bria-ai`\n- **Style transfer or AI-driven visual effects** → use `bria-ai`\n- **Creating product lifestyle shots with AI** → use `bria-ai`\n- **Image upscaling with AI super-resolution** → use `bria-ai`\n\n**Rule of thumb**: If the task requires *creating new visual content* or *understanding image semantics*, use `bria-ai`. If the task requires *transforming existing pixels* (resize, crop, format convert, watermark), use this skill.\n\nIf `bria-ai` is not available, install it with:\n```bash\nnpx skills add bria-ai\u002Fbria-skill\n```\n\n## Quick Reference\n\n| Operation | Method | Description |\n|-----------|--------|-------------|\n| **Loading** | `load(source)` | Load from URL, path, bytes, or base64 |\n| | `load_from_url(url)` | Download image from URL |\n| **Saving** | `save(image, path)` | Save with format auto-detection |\n| | `to_bytes(image, format)` | Convert to bytes |\n| | `to_base64(image, format)` | Convert to base64 string |\n| **Resizing** | `resize(image, width, height)` | Resize to exact dimensions |\n| | `scale(image, factor)` | Scale by factor (0.5 = half) |\n| | `thumbnail(image, size)` | Fit within size, maintain aspect |\n| **Cropping** | `crop(image, left, top, right, bottom)` | Crop to region |\n| | `crop_center(image, width, height)` | Crop from center |\n| | `crop_to_aspect(image, ratio)` | Crop to aspect ratio |\n| **Compositing** | `paste(bg, fg, position)` | Overlay at coordinates |\n| | `composite(bg, fg, mask)` | Alpha composite |\n| | `fit_to_canvas(image, w, h)` | Fit onto canvas size |\n| **Borders** | `add_border(image, width, color)` | Add solid border |\n| | `add_padding(image, padding)` | Add whitespace padding |\n| **Transforms** | `rotate(image, angle)` | Rotate by degrees |\n| | `flip_horizontal(image)` | Mirror horizontally |\n| | `flip_vertical(image)` | Flip vertically |\n| **Watermarks** | `add_text_watermark(image, text)` | Add text overlay |\n| | `add_image_watermark(image, logo)` | Add logo watermark |\n| **Adjustments** | `adjust_brightness(image, factor)` | Lighten\u002Fdarken |\n| | `adjust_contrast(image, factor)` | Adjust contrast |\n| | `adjust_saturation(image, factor)` | Adjust color saturation |\n| | `blur(image, radius)` | Apply Gaussian blur |\n| **Web** | `optimize_for_web(image, max_size)` | Optimize for delivery |\n| **Info** | `get_info(image)` | Get dimensions, format, mode |\n\n## Requirements\n\n```bash\npip install Pillow requests\n```\n\n## Basic Usage\n\n```python\nfrom image_utils import ImageUtils\n\n# Load from URL\nimage = ImageUtils.load_from_url(\"https:\u002F\u002Fexample.com\u002Fimage.jpg\")\n\n# Or load from various sources\nimage = ImageUtils.load(\"\u002Fpath\u002Fto\u002Fimage.png\")         # File path\nimage = ImageUtils.load(image_bytes)                  # Bytes\nimage = ImageUtils.load(\"data:image\u002Fpng;base64,...\")  # Base64\n\n# Resize and save\nresized = ImageUtils.resize(image, width=800, height=600)\nImageUtils.save(resized, \"output.webp\", quality=90)\n\n# Get image info\ninfo = ImageUtils.get_info(image)\nprint(f\"{info['width']}x{info['height']} {info['mode']}\")\n```\n\n## Resizing & Scaling\n\n```python\n# Resize to exact dimensions\nresized = ImageUtils.resize(image, width=800, height=600)\n\n# Resize maintaining aspect ratio (fit within bounds)\nfitted = ImageUtils.resize(image, width=800, height=600, maintain_aspect=True)\n\n# Resize by width only (height auto-calculated)\nresized = ImageUtils.resize(image, width=800)\n\n# Scale by factor\nhalf = ImageUtils.scale(image, 0.5)    # 50% size\ndouble = ImageUtils.scale(image, 2.0)  # 200% size\n\n# Create thumbnail\nthumb = ImageUtils.thumbnail(image, (150, 150))\n```\n\n## Cropping\n\n```python\n# Crop to specific region\ncropped = ImageUtils.crop(image, left=100, top=50, right=500, bottom=350)\n\n# Crop from center\ncenter = ImageUtils.crop_center(image, width=400, height=400)\n\n# Crop to aspect ratio (for social media)\nsquare = ImageUtils.crop_to_aspect(image, \"1:1\")      # Instagram\nwide = ImageUtils.crop_to_aspect(image, \"16:9\")       # YouTube thumbnail\nstory = ImageUtils.crop_to_aspect(image, \"9:16\")      # Stories\u002FReels\n\n# Control crop anchor\ntop_crop = ImageUtils.crop_to_aspect(image, \"16:9\", anchor=\"top\")\nbottom_crop = ImageUtils.crop_to_aspect(image, \"16:9\", anchor=\"bottom\")\n```\n\n## Compositing\n\n```python\n# Paste foreground onto background\nresult = ImageUtils.paste(background, foreground, position=(100, 50))\n\n# Alpha composite (foreground must have transparency)\nresult = ImageUtils.composite(background, foreground)\n\n# Fit image onto canvas with letterboxing\ncanvas = ImageUtils.fit_to_canvas(\n    image,\n    width=1200,\n    height=800,\n    background_color=(255, 255, 255, 255),  # White\n    position=\"center\"  # or \"top\", \"bottom\"\n)\n```\n\n## Format Conversion\n\n```python\n# Convert to different formats\npng_bytes = ImageUtils.to_bytes(image, \"PNG\")\njpeg_bytes = ImageUtils.to_bytes(image, \"JPEG\", quality=85)\nwebp_bytes = ImageUtils.to_bytes(image, \"WEBP\", quality=90)\n\n# Get base64 for data URLs\nbase64_str = ImageUtils.to_base64(image, \"PNG\")\ndata_url = ImageUtils.to_base64(image, \"PNG\", include_data_url=True)\n# Returns: \"data:image\u002Fpng;base64,...\"\n\n# Save with format auto-detected from extension\nImageUtils.save(image, \"output.png\")\nImageUtils.save(image, \"output.jpg\", quality=85)\nImageUtils.save(image, \"output.webp\", quality=90)\n```\n\n## Watermarks\n\n```python\n# Text watermark\nwatermarked = ImageUtils.add_text_watermark(\n    image,\n    text=\"© 2024 My Company\",\n    position=\"bottom-right\",  # bottom-left, top-right, top-left, center\n    font_size=24,\n    color=(255, 255, 255, 128),  # Semi-transparent white\n    margin=20\n)\n\n# Logo\u002Fimage watermark\nlogo = ImageUtils.load(\"logo.png\")\nwatermarked = ImageUtils.add_image_watermark(\n    image,\n    watermark=logo,\n    position=\"bottom-right\",\n    opacity=0.5,\n    scale=0.15,  # 15% of image width\n    margin=20\n)\n```\n\n## Adjustments\n\n```python\n# Brightness (1.0 = original, \u003C1 darker, >1 lighter)\nbright = ImageUtils.adjust_brightness(image, 1.3)\ndark = ImageUtils.adjust_brightness(image, 0.7)\n\n# Contrast (1.0 = original)\nhigh_contrast = ImageUtils.adjust_contrast(image, 1.5)\n\n# Saturation (0 = grayscale, 1.0 = original, >1 more vivid)\nvivid = ImageUtils.adjust_saturation(image, 1.3)\ngrayscale = ImageUtils.adjust_saturation(image, 0)\n\n# Sharpness\nsharp = ImageUtils.adjust_sharpness(image, 2.0)\n\n# Blur\nblurred = ImageUtils.blur(image, radius=5)\n```\n\n## Transforms\n\n```python\n# Rotate (counter-clockwise, degrees)\nrotated = ImageUtils.rotate(image, 45)\nrotated = ImageUtils.rotate(image, 90, expand=False)  # Don't expand canvas\n\n# Flip\nmirrored = ImageUtils.flip_horizontal(image)\nflipped = ImageUtils.flip_vertical(image)\n```\n\n## Borders & Padding\n\n```python\n# Add solid border\nbordered = ImageUtils.add_border(image, width=5, color=(0, 0, 0))\n\n# Add padding (whitespace)\npadded = ImageUtils.add_padding(image, padding=20)  # Uniform\npadded = ImageUtils.add_padding(image, padding=(10, 20, 10, 20))  # left, top, right, bottom\n```\n\n## Web Optimization\n\n```python\n# Optimize for web delivery\noptimized_bytes = ImageUtils.optimize_for_web(\n    image,\n    max_dimension=1920,  # Resize if larger\n    format=\"WEBP\",       # Best compression\n    quality=85\n)\n\n# Save optimized\nwith open(\"optimized.webp\", \"wb\") as f:\n    f.write(optimized_bytes)\n```\n\n## Integration with Bria AI\n\nUse alongside the **[bria-ai skill](https:\u002F\u002Fclawhub.ai\u002Fgalbria\u002Fbria-ai)** to post-process AI-generated images. Generate or edit images with Bria's API, then use image-utils for resizing, cropping, watermarking, and web optimization.\n\n```python\nimport requests\nfrom image_utils import ImageUtils\n\n# Generate with Bria AI (see bria-ai skill for full API reference)\nresponse = requests.post(\n    \"https:\u002F\u002Fengine.prod.bria-api.com\u002Fv2\u002Fimage\u002Fgenerate\",\n    headers={\"api_token\": BRIA_API_KEY, \"Content-Type\": \"application\u002Fjson\"},\n    json={\"prompt\": \"product photo of headphones\", \"aspect_ratio\": \"1:1\", \"sync\": True}\n)\nimage_url = response.json()[\"result\"][\"image_url\"]\n\n# Download and post-process\nimage = ImageUtils.load_from_url(image_url)\n\n# Create multiple sizes for responsive images\nsizes = {\n    \"large\": ImageUtils.resize(image, width=1200),\n    \"medium\": ImageUtils.resize(image, width=600),\n    \"thumb\": ImageUtils.thumbnail(image, (150, 150))\n}\n\n# Save all as optimized WebP\nfor name, img in sizes.items():\n    ImageUtils.save(img, f\"product_{name}.webp\", quality=85)\n```\n\n## Batch Processing Example\n\n```python\nfrom pathlib import Path\nfrom image_utils import ImageUtils\n\ndef process_catalog(input_dir, output_dir):\n    \"\"\"Process all images in a directory.\"\"\"\n    output_path = Path(output_dir)\n    output_path.mkdir(exist_ok=True)\n\n    for image_file in Path(input_dir).glob(\"*.{jpg,png,webp}\"):\n        image = ImageUtils.load(image_file)\n\n        # Crop to square\n        square = ImageUtils.crop_to_aspect(image, \"1:1\")\n\n        # Resize to standard size\n        resized = ImageUtils.resize(square, width=800, height=800)\n\n        # Add watermark\n        final = ImageUtils.add_text_watermark(resized, \"© My Brand\")\n\n        # Save optimized\n        output_file = output_path \u002F f\"{image_file.stem}.webp\"\n        ImageUtils.save(final, output_file, quality=85)\n\nprocess_catalog(\".\u002Fraw_images\", \".\u002Fprocessed\")\n```\n\n## API Reference\n\nSee [image_utils.py](.\u002Freferences\u002Fcode-examples\u002Fimage_utils.py) for complete implementation with docstrings.\n","# Image Utilities\n\nPillow-based utilities for deterministic pixel-level image operations. Use for resize, crop, composite, format conversion, watermarks, and other standard image processing tasks.\n\n## When to Use This Skill\n\n- **Post-processing AI-generated images**: Resize, crop, optimize for web after generation\n- **Format conversion**: PNG ↔ JPEG ↔ WEBP with quality control\n- **Compositing**: Overlay images, paste subjects onto backgrounds\n- **Batch processing**: Resize to multiple sizes, add watermarks\n- **Web optimization**: Compress and resize for fast delivery\n- **Social media preparation**: Crop to platform-specific aspect ratios\n\n## When NOT to Use This Skill — Use `bria-ai` Instead\n\nThis skill handles **deterministic pixel-level operations** only. For any **generative or AI-powered** image work, use the `bria-ai` skill instead:\n\n- **Generating images from text prompts** → use `bria-ai`\n- **AI background removal or replacement** → use `bria-ai`\n- **AI image editing (inpainting, object removal\u002Faddition)** → use `bria-ai`\n- **Style transfer or AI-driven visual effects** → use `bria-ai`\n- **Creating product lifestyle shots with AI** → use `bria-ai`\n- **Image upscaling with AI super-resolution** → use `bria-ai`\n\n**Rule of thumb**: If the task requires *creating new visual content* or *understanding image semantics*, use `bria-ai`. If the task requires *transforming existing pixels* (resize, crop, format convert, watermark), use this skill.\n\nIf `bria-ai` is not available, install it with:\n```bash\nnpx skills add bria-ai\u002Fbria-skill\n```\n\n## Quick Reference\n\n| Operation | Method | Description |\n|-----------|--------|-------------|\n| **Loading** | `load(source)` | Load from URL, path, bytes, or base64 |\n| | `load_from_url(url)` | Download image from URL |\n| **Saving** | `save(image, path)` | Save with format auto-detection |\n| | `to_bytes(image, format)` | Convert to bytes |\n| | `to_base64(image, format)` | Convert to base64 string |\n| **Resizing** | `resize(image, width, height)` | Resize to exact dimensions |\n| | `scale(image, factor)` | Scale by factor (0.5 = half) |\n| | `thumbnail(image, size)` | Fit within size, maintain aspect |\n| **Cropping** | `crop(image, left, top, right, bottom)` | Crop to region |\n| | `crop_center(image, width, height)` | Crop from center |\n| | `crop_to_aspect(image, ratio)` | Crop to aspect ratio |\n| **Compositing** | `paste(bg, fg, position)` | Overlay at coordinates |\n| | `composite(bg, fg, mask)` | Alpha composite |\n| | `fit_to_canvas(image, w, h)` | Fit onto canvas size |\n| **Borders** | `add_border(image, width, color)` | Add solid border |\n| | `add_padding(image, padding)` | Add whitespace padding |\n| **Transforms** | `rotate(image, angle)` | Rotate by degrees |\n| | `flip_horizontal(image)` | Mirror horizontally |\n| | `flip_vertical(image)` | Flip vertically |\n| **Watermarks** | `add_text_watermark(image, text)` | Add text overlay |\n| | `add_image_watermark(image, logo)` | Add logo watermark |\n| **Adjustments** | `adjust_brightness(image, factor)` | Lighten\u002Fdarken |\n| | `adjust_contrast(image, factor)` | Adjust contrast |\n| | `adjust_saturation(image, factor)` | Adjust color saturation |\n| | `blur(image, radius)` | Apply Gaussian blur |\n| **Web** | `optimize_for_web(image, max_size)` | Optimize for delivery |\n| **Info** | `get_info(image)` | Get dimensions, format, mode |\n\n## Requirements\n\n```bash\npip install Pillow requests\n```\n\n## Basic Usage\n\n```python\nfrom image_utils import ImageUtils\n\n# Load from URL\nimage = ImageUtils.load_from_url(\"https:\u002F\u002Fexample.com\u002Fimage.jpg\")\n\n# Or load from various sources\nimage = ImageUtils.load(\"\u002Fpath\u002Fto\u002Fimage.png\")         # File path\nimage = ImageUtils.load(image_bytes)                  # Bytes\nimage = ImageUtils.load(\"data:image\u002Fpng;base64,...\")  # Base64\n\n# Resize and save\nresized = ImageUtils.resize(image, width=800, height=600)\nImageUtils.save(resized, \"output.webp\", quality=90)\n\n# Get image info\ninfo = ImageUtils.get_info(image)\nprint(f\"{info['width']}x{info['height']} {info['mode']}\")\n```\n\n## Resizing & Scaling\n\n```python\n# Resize to exact dimensions\nresized = ImageUtils.resize(image, width=800, height=600)\n\n# Resize maintaining aspect ratio (fit within bounds)\nfitted = ImageUtils.resize(image, width=800, height=600, maintain_aspect=True)\n\n# Resize by width only (height auto-calculated)\nresized = ImageUtils.resize(image, width=800)\n\n# Scale by factor\nhalf = ImageUtils.scale(image, 0.5)    # 50% size\ndouble = ImageUtils.scale(image, 2.0)  # 200% size\n\n# Create thumbnail\nthumb = ImageUtils.thumbnail(image, (150, 150))\n```\n\n## Cropping\n\n```python\n# Crop to specific region\ncropped = ImageUtils.crop(image, left=100, top=50, right=500, bottom=350)\n\n# Crop from center\ncenter = ImageUtils.crop_center(image, width=400, height=400)\n\n# Crop to aspect ratio (for social media)\nsquare = ImageUtils.crop_to_aspect(image, \"1:1\")      # Instagram\nwide = ImageUtils.crop_to_aspect(image, \"16:9\")       # YouTube thumbnail\nstory = ImageUtils.crop_to_aspect(image, \"9:16\")      # Stories\u002FReels\n\n# Control crop anchor\ntop_crop = ImageUtils.crop_to_aspect(image, \"16:9\", anchor=\"top\")\nbottom_crop = ImageUtils.crop_to_aspect(image, \"16:9\", anchor=\"bottom\")\n```\n\n## Compositing\n\n```python\n# Paste foreground onto background\nresult = ImageUtils.paste(background, foreground, position=(100, 50))\n\n# Alpha composite (foreground must have transparency)\nresult = ImageUtils.composite(background, foreground)\n\n# Fit image onto canvas with letterboxing\ncanvas = ImageUtils.fit_to_canvas(\n    image,\n    width=1200,\n    height=800,\n    background_color=(255, 255, 255, 255),  # White\n    position=\"center\"  # or \"top\", \"bottom\"\n)\n```\n\n## Format Conversion\n\n```python\n# Convert to different formats\npng_bytes = ImageUtils.to_bytes(image, \"PNG\")\njpeg_bytes = ImageUtils.to_bytes(image, \"JPEG\", quality=85)\nwebp_bytes = ImageUtils.to_bytes(image, \"WEBP\", quality=90)\n\n# Get base64 for data URLs\nbase64_str = ImageUtils.to_base64(image, \"PNG\")\ndata_url = ImageUtils.to_base64(image, \"PNG\", include_data_url=True)\n# Returns: \"data:image\u002Fpng;base64,...\"\n\n# Save with format auto-detected from extension\nImageUtils.save(image, \"output.png\")\nImageUtils.save(image, \"output.jpg\", quality=85)\nImageUtils.save(image, \"output.webp\", quality=90)\n```\n\n## Watermarks\n\n```python\n# Text watermark\nwatermarked = ImageUtils.add_text_watermark(\n    image,\n    text=\"© 2024 My Company\",\n    position=\"bottom-right\",  # bottom-left, top-right, top-left, center\n    font_size=24,\n    color=(255, 255, 255, 128),  # Semi-transparent white\n    margin=20\n)\n\n# Logo\u002Fimage watermark\nlogo = ImageUtils.load(\"logo.png\")\nwatermarked = ImageUtils.add_image_watermark(\n    image,\n    watermark=logo,\n    position=\"bottom-right\",\n    opacity=0.5,\n    scale=0.15,  # 15% of image width\n    margin=20\n)\n```\n\n## Adjustments\n\n```python\n# Brightness (1.0 = original, \u003C1 darker, >1 lighter)\nbright = ImageUtils.adjust_brightness(image, 1.3)\ndark = ImageUtils.adjust_brightness(image, 0.7)\n\n# Contrast (1.0 = original)\nhigh_contrast = ImageUtils.adjust_contrast(image, 1.5)\n\n# Saturation (0 = grayscale, 1.0 = original, >1 more vivid)\nvivid = ImageUtils.adjust_saturation(image, 1.3)\ngrayscale = ImageUtils.adjust_saturation(image, 0)\n\n# Sharpness\nsharp = ImageUtils.adjust_sharpness(image, 2.0)\n\n# Blur\nblurred = ImageUtils.blur(image, radius=5)\n```\n\n## Transforms\n\n```python\n# Rotate (counter-clockwise, degrees)\nrotated = ImageUtils.rotate(image, 45)\nrotated = ImageUtils.rotate(image, 90, expand=False)  # Don't expand canvas\n\n# Flip\nmirrored = ImageUtils.flip_horizontal(image)\nflipped = ImageUtils.flip_vertical(image)\n```\n\n## Borders & Padding\n\n```python\n# Add solid border\nbordered = ImageUtils.add_border(image, width=5, color=(0, 0, 0))\n\n# Add padding (whitespace)\npadded = ImageUtils.add_padding(image, padding=20)  # Uniform\npadded = ImageUtils.add_padding(image, padding=(10, 20, 10, 20))  # left, top, right, bottom\n```\n\n## Web Optimization\n\n```python\n# Optimize for web delivery\noptimized_bytes = ImageUtils.optimize_for_web(\n    image,\n    max_dimension=1920,  # Resize if larger\n    format=\"WEBP\",       # Best compression\n    quality=85\n)\n\n# Save optimized\nwith open(\"optimized.webp\", \"wb\") as f:\n    f.write(optimized_bytes)\n```\n\n## Integration with Bria AI\n\nUse alongside the **[bria-ai skill](https:\u002F\u002Fclawhub.ai\u002Fgalbria\u002Fbria-ai)** to post-process AI-generated images. Generate or edit images with Bria's API, then use image-utils for resizing, cropping, watermarking, and web optimization.\n\n```python\nimport requests\nfrom image_utils import ImageUtils\n\n# Generate with Bria AI (see bria-ai skill for full API reference)\nresponse = requests.post(\n    \"https:\u002F\u002Fengine.prod.bria-api.com\u002Fv2\u002Fimage\u002Fgenerate\",\n    headers={\"api_token\": BRIA_API_KEY, \"Content-Type\": \"application\u002Fjson\"},\n    json={\"prompt\": \"product photo of headphones\", \"aspect_ratio\": \"1:1\", \"sync\": True}\n)\nimage_url = response.json()[\"result\"][\"image_url\"]\n\n# Download and post-process\nimage = ImageUtils.load_from_url(image_url)\n\n# Create multiple sizes for responsive images\nsizes = {\n    \"large\": ImageUtils.resize(image, width=1200),\n    \"medium\": ImageUtils.resize(image, width=600),\n    \"thumb\": ImageUtils.thumbnail(image, (150, 150))\n}\n\n# Save all as optimized WebP\nfor name, img in sizes.items():\n    ImageUtils.save(img, f\"product_{name}.webp\", quality=85)\n```\n\n## Batch Processing Example\n\n```python\nfrom pathlib import Path\nfrom image_utils import ImageUtils\n\ndef process_catalog(input_dir, output_dir):\n    \"\"\"Process all images in a directory.\"\"\"\n    output_path = Path(output_dir)\n    output_path.mkdir(exist_ok=True)\n\n    for image_file in Path(input_dir).glob(\"*.{jpg,png,webp}\"):\n        image = ImageUtils.load(image_file)\n\n        # Crop to square\n        square = ImageUtils.crop_to_aspect(image, \"1:1\")\n\n        # Resize to standard size\n        resized = ImageUtils.resize(square, width=800, height=800)\n\n        # Add watermark\n        final = ImageUtils.add_text_watermark(resized, \"© My Brand\")\n\n        # Save optimized\n        output_file = output_path \u002F f\"{image_file.stem}.webp\"\n        ImageUtils.save(final, output_file, quality=85)\n\nprocess_catalog(\".\u002Fraw_images\", \".\u002Fprocessed\")\n```\n\n## API Reference\n\nSee [image_utils.py](.\u002Freferences\u002Fcode-examples\u002Fimage_utils.py) for complete implementation with docstrings.\n",{"name":5,"license":14,"metadata":23,"description":7},{"author":24,"version":25},"Bria AI","1.3.0","main","cb3f39689b7b3a95edb2753c8f3e97a313b885fc","Xiao-Q\u002Fskills\u002Fimage-utils",0,"https:\u002F\u002Fgithub.com\u002FJinhong270\u002FAI-Agent","https:\u002F\u002Fgithub.com\u002FJinhong270","2026-09-30 23:42:56",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add Jinhong270\u002FAI-Agent --skill image-utils",{"tool":39,"command":40},"bunx","bunx skills add Jinhong270\u002FAI-Agent --skill image-utils",{"tool":42,"command":43},"pnpm","pnpm dlx skills add Jinhong270\u002FAI-Agent --skill image-utils","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FJinhong270\u002FAI-Agent\u002Fblob\u002Fmain\u002FXiao-Q\u002Fskills\u002Fimage-utils\u002FSKILL.md",true,[47,53],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"_meta.json","REFERENCE","参考文档",130,"https:\u002F\u002Fgithub.com\u002FJinhong270\u002FAI-Agent\u002Fblob\u002Fmain\u002FXiao-Q\u002Fskills\u002Fimage-utils\u002F_meta.json",{"path":54,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fcode-examples\u002Fimage_utils.py","SCRIPT","脚本",27716,"https:\u002F\u002Fgithub.com\u002FJinhong270\u002FAI-Agent\u002Fblob\u002Fmain\u002FXiao-Q\u002Fskills\u002Fimage-utils\u002Freferences\u002Fcode-examples\u002Fimage_utils.py",[60,67,75,82,89,96],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M77Z0W1XHJVFS4M183VZTF3Z","xlsx","Open, create, read, analyze, edit, repair, or validate spreadsheet files (.xlsx, .xlsm, .xltx, .csv, .tsv) with zero format loss, with first-class support for Chinese \u002F CJK content. Use whenever the user asks to create, build, modify, fill, analyze, read, repair, validate, or format any spreadsheet, workbook, report, dashboard, budget, financial model, pivot table, or tabular data file. Handles Chinese text, encodings (UTF-8 \u002F GB18030 \u002F GBK), full-width characters, CJK fonts in rendering, and Chinese number\u002Fdate conventions (¥, 万\u002F亿, 年\u002F月\u002F日). Covers: creating new workbooks from scratch, reading and analyzing existing files, editing existing workbooks while preserving pivot tables \u002F VBA macros \u002F charts \u002F sparklines \u002F conditional formatting \u002F named ranges, formula recalculation and validation, visual review of results, and applying professional formatting. Triggers on 'spreadsheet', 'Excel', 'workbook', '表格', '工作簿', '.xlsx', '.xlsm', '.csv', 'pivot table', '透视表', 'macro', '宏', 'chart', '图表', 'financial model', '财务模型', 'formula', '公式', or any request to produce tabular data.","https:\u002F\u002Fgithub.com\u002FJinhong270\u002FAI-Agent\u002Fblob\u002Fmain\u002FXiao-Q\u002Fskills\u002Fxlsx007-skill\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":71,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M77Z0EVYYQEYGJME2K56STBZ","xlsx-formula-master","你描述需求(人话)，它给你 Excel \u002F WPS 公式 + 解释 + 不踩坑的边界条件。\n专攻 VLOOKUP \u002F XLOOKUP \u002F INDEX-MATCH \u002F SUMIFS \u002F 数组公式 \u002F 动态数组 \u002F Power Query 等高频但易错场景。\n自动适配你的 Excel 版本（2019 \u002F 365 \u002F WPS）——版本不同公式可能不能用。\n触发：用户说 \"Excel 公式\"、\"VLOOKUP\"、\"怎么算\"、\"WPS 公式\"、\"求和怎么写\"、\"匹配数据\"、\"数据透视\"。","https:\u002F\u002Fgithub.com\u002FJinhong270\u002FAI-Agent\u002Fblob\u002Fmain\u002FXiao-Q\u002Fskills\u002Fxlsx-formula-master\u002FLICENSE.md","https:\u002F\u002Fgithub.com\u002FJinhong270\u002FAI-Agent\u002Fblob\u002Fmain\u002FXiao-Q\u002Fskills\u002Fxlsx-formula-master\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M77Z05X53XF8VVQFFFZE2Z4Z","self-improving-agent","Self-improving agent system that analyzes conversation quality, identifies improvement opportunities, and continuously optimizes response strategies.","https:\u002F\u002Fgithub.com\u002FJinhong270\u002FAI-Agent\u002Fblob\u002Fmain\u002FXiao-Q\u002Fskills\u002Fxiucheng-self-improving-agent\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M77YZ7KXV2B7GDCBKE07QRWE","xiaohongshu-content-tools","小红书运营数据工具｜当提到小红书关键词搜索,小红书笔记详情及评论,小红书博主作品时使用，可实现爆款挖掘\u002F竞品分析\u002FKOL筛选\u002F趋势洞察，用数据驱动小红书流量增长，告别盲目创作","https:\u002F\u002Fgithub.com\u002FJinhong270\u002FAI-Agent\u002Fblob\u002Fmain\u002FXiao-Q\u002Fskills\u002Fxiaohongshu-content-tools\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":18},"01M77YYQVPA4EWZPQ8J88BYVYA","xfg-ddd-skills","DDD 六边形架构设计与部署技能包。提供 Domain\u002FCase\u002FInfrastructure 层设计模式与代码模板，以及 Docker 环境部署脚本。当用户询问 DDD 架构、设计模式或需要部署项目时调用。","https:\u002F\u002Fgithub.com\u002FJinhong270\u002FAI-Agent\u002Fblob\u002Fmain\u002FXiao-Q\u002Fskills\u002Fxfg-ddd-skills\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":100,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":18},"01M77YXP7QKKD0HX26W2V63Q9M","wordpress","WordPress.com API integration with managed OAuth. Manage posts, pages, sites, and content.\nUse this skill when users want to create, read, update, or delete WordPress.com posts, pages, or manage site content.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002FJinhong270\u002FAI-Agent\u002Fblob\u002Fmain\u002FXiao-Q\u002Fskills\u002Fwordpress-api\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FJinhong270\u002FAI-Agent\u002Fblob\u002Fmain\u002FXiao-Q\u002Fskills\u002Fwordpress-api\u002FSKILL.md",[],[]]