[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6PRZFY2AK0QB48A0330FB8Q":3,"skill-same:01M6PRZFY2AK0QB48A0330FB8Q":89},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":31,"publishedAt":52,"linkOnly":53,"markdownContent":54,"markdownBody":55,"frontMatter":56,"refName":63,"commitSha":64,"skillDirectory":65,"forksCount":14,"repositoryHtmlUrl":66,"repositoryHomepageUrl":6,"ownerHtmlUrl":67,"ownerBlogUrl":68,"ownerDescription":6,"updatedAt":69,"install":70,"resources":82},"01M6PRZFY2AK0QB48A0330FB8Q","seo-images",null,"Image optimization analysis for SEO and performance. Checks alt text, file sizes, formats, responsive images, lazy loading, CLS prevention, image SERP rankings (via DataForSEO), and image file optimization (WebP\u002FAVIF conversion, IPTC\u002FXMP metadata injection). Use when user says \"image optimization\", \"alt text\", \"image SEO\", \"image size\", \"image audit\", \"optimize images\", \"image metadata\", \"image SERP\", \"convert to webp\", or \"image file optimize\".","headmktlucca-ui\u002Fneuroads-lp","headmktlucca-ui","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F247379838?v=4","01M6PDVAV6M1W96D1SR1PDF8CS","NeuroAds","01M6PDVAZ4P281GNDKD45CYTF5",0,"MIT","https:\u002F\u002Fgithub.com\u002Fheadmktlucca-ui\u002Fneuroads-lp\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fseo-images\u002FSKILL.md",[18,23,26],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000016","图像与多媒体","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000019","营销推广",{"categoryNo":27,"categoryName":28,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000035","市场营销","PROFESSION","适用职业",[32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51],"seo","images","seo images","lazy","image","for","formats","URL","loading","responsive","optimize","conversion","text","webp","analysis","prevention","injection","Optimization","audit","performance","2026-11-10 10:12:30",false,"---\nname: seo-images\ndescription: >\n  Image optimization analysis for SEO and performance. Checks alt text, file\n  sizes, formats, responsive images, lazy loading, CLS prevention, image SERP\n  rankings (via DataForSEO), and image file optimization (WebP\u002FAVIF conversion,\n  IPTC\u002FXMP metadata injection). Use when user says \"image optimization\",\n  \"alt text\", \"image SEO\", \"image size\", \"image audit\", \"optimize images\",\n  \"image metadata\", \"image SERP\", \"convert to webp\", or \"image file optimize\".\nuser-invocable: true\nargument-hint: \"[url]\"\nlicense: MIT\nmetadata:\n  author: AgriciDaniel\n  version: \"2.2.0\"\n  category: seo\n---\n\n# Image Optimization Analysis\n\n## Checks\n\n### Alt Text\n- Present on all `\u003Cimg>` elements (except decorative: `role=\"presentation\"`)\n- Descriptive: describes the image content, not \"image.jpg\" or \"photo\"\n- Includes relevant keywords where natural, not keyword-stuffed\n- Length: 10-125 characters\n\n**Good examples:**\n- \"Professional plumber repairing kitchen sink faucet\"\n- \"Red 2024 Toyota Camry sedan front view\"\n- \"Team meeting in modern office conference room\"\n\n**Bad examples:**\n- \"image.jpg\" (filename, not description)\n- \"plumber plumbing plumber services\" (keyword stuffing)\n- \"Click here\" (not descriptive)\n\n### File Size\n\n**Tiered thresholds by image category:**\n\n| Image Category | Target | Warning | Critical |\n|----------------|--------|---------|----------|\n| Thumbnails | \u003C 50KB | > 100KB | > 200KB |\n| Content images | \u003C 100KB | > 200KB | > 500KB |\n| Hero\u002Fbanner images | \u003C 200KB | > 300KB | > 700KB |\n\nRecommend compression to target thresholds where possible without quality loss.\n\n### Format\n| Format | Browser Support | Use Case |\n|--------|-----------------|----------|\n| WebP | 97%+ | Default recommendation |\n| AVIF | 92%+ | Best compression, newer |\n| JPEG | 100% | Fallback for photos |\n| PNG | 100% | Graphics with transparency |\n| SVG | 100% | Icons, logos, illustrations |\n\nRecommend WebP\u002FAVIF over JPEG\u002FPNG. Check for `\u003Cpicture>` element with format fallbacks.\n\n#### Recommended `\u003Cpicture>` Element Pattern\n\nUse progressive enhancement with the most efficient format first:\n\n```html\n\u003Cpicture>\n  \u003Csource srcset=\"image.avif\" type=\"image\u002Favif\">\n  \u003Csource srcset=\"image.webp\" type=\"image\u002Fwebp\">\n  \u003Cimg src=\"image.jpg\" alt=\"Descriptive alt text\" width=\"800\" height=\"600\" loading=\"lazy\" decoding=\"async\">\n\u003C\u002Fpicture>\n```\n\nThe browser will use the first supported format. Current browser support: AVIF 93.8%, WebP 95.3%.\n\n#### JPEG XL: Emerging Format\n\nIn November 2025, Google's Chromium team reversed its 2022 decision and announced it will restore JPEG XL support in Chrome using a Rust-based decoder. The implementation is feature-complete but not yet in Chrome stable. JPEG XL offers lossless JPEG recompression (~20% savings with zero quality loss) and competitive lossy compression. Not yet practical for web deployment, but worth monitoring for future adoption.\n\n### Responsive Images\n- `srcset` attribute for multiple sizes\n- `sizes` attribute matching layout breakpoints\n- Appropriate resolution for device pixel ratios\n\n```html\n\u003Cimg\n  src=\"image-800.jpg\"\n  srcset=\"image-400.jpg 400w, image-800.jpg 800w, image-1200.jpg 1200w\"\n  sizes=\"(max-width: 600px) 400px, (max-width: 1200px) 800px, 1200px\"\n  alt=\"Description\"\n>\n```\n\n### Lazy Loading\n- `loading=\"lazy\"` on below-fold images\n- Do NOT lazy-load above-fold\u002Fhero images (hurts LCP)\n- Check for native vs JavaScript-based lazy loading\n\n```html\n\u003C!-- Below fold - lazy load -->\n\u003Cimg src=\"photo.jpg\" loading=\"lazy\" alt=\"Description\">\n\n\u003C!-- Above fold - eager load (default) -->\n\u003Cimg src=\"hero.jpg\" alt=\"Hero image\">\n```\n\n#### Detected lazy-loader methods (`lazy_method` field)\n\n`scripts\u002Fparse_html.py` classifies each image's lazy-loading mechanism via the\n`lazy_method` field on every image entry. Five values:\n\n| `lazy_method` | Signal detected | Common stack |\n|---|---|---|\n| `native` | `loading=\"lazy\"` HTML attribute | Modern browsers, plain HTML |\n| `perfmatters` | `data-perfmatters-src`\u002F`-srcset` OR class `perfmatters-lazy` | WordPress + Perfmatters plugin |\n| `ewww` | `data-ewww-src` \u002F `data-eio` OR class `lazyload-eio` | WordPress + EWWW Image Optimizer |\n| `js-generic` | `data-src` \u002F `data-lazy-src` \u002F `data-original` \u002F `data-srcset` OR class `lazyload`\u002F`lazyloaded`\u002F`lazy` | Lazysizes, vanilla-lazyload, jQuery plugins |\n| `none` | Neither attribute nor class signal | Page is not lazy-loading this image |\n\nWhen auditing image SEO, report `lazy_method` alongside `loading` so users know\nwhether their site is using a JS-driven lazy-loader (in which case the native\n`loading=\"lazy\"` attribute is intentionally absent — that is not a regression).\n\n### `fetchpriority=\"high\"` for LCP Images\n\nAdd `fetchpriority=\"high\"` to your hero\u002FLCP image to prioritize its download in the browser's network queue:\n\n```html\n\u003Cimg src=\"hero.webp\" fetchpriority=\"high\" alt=\"Hero image description\" width=\"1200\" height=\"630\">\n```\n\n**Critical:** Do NOT lazy-load above-the-fold\u002FLCP images. Using `loading=\"lazy\"` on LCP images directly harms LCP scores. Reserve `loading=\"lazy\"` for below-the-fold images only.\n\n### `decoding=\"async\"` for Non-LCP Images\n\nAdd `decoding=\"async\"` to non-LCP images to prevent image decoding from blocking the main thread:\n\n```html\n\u003Cimg src=\"photo.webp\" alt=\"Description\" width=\"600\" height=\"400\" loading=\"lazy\" decoding=\"async\">\n```\n\n### CLS Prevention\n- `width` and `height` attributes set on all `\u003Cimg>` elements\n- `aspect-ratio` CSS as alternative\n- Flag images without dimensions\n\n```html\n\u003C!-- Good - dimensions set -->\n\u003Cimg src=\"photo.jpg\" width=\"800\" height=\"600\" alt=\"Description\">\n\n\u003C!-- Good - CSS aspect ratio -->\n\u003Cimg src=\"photo.jpg\" style=\"aspect-ratio: 4\u002F3\" alt=\"Description\">\n\n\u003C!-- Bad - no dimensions -->\n\u003Cimg src=\"photo.jpg\" alt=\"Description\">\n```\n\n### File Names\n- Descriptive: `blue-running-shoes.webp` not `IMG_1234.jpg`\n- Hyphenated, lowercase, no special characters\n- Include relevant keywords\n\n### CDN Usage\n- Check if images served from CDN (different domain, CDN headers)\n- Recommend CDN for image-heavy sites\n- Check for edge caching headers\n\n## Output\n\n### Image Audit Summary\n\n| Metric | Status | Count |\n|--------|--------|-------|\n| Total Images | - | XX |\n| Missing Alt Text | ❌ | XX |\n| Oversized (>200KB) | ⚠️ | XX |\n| Wrong Format | ⚠️ | XX |\n| No Dimensions | ⚠️ | XX |\n| Not Lazy Loaded | ⚠️ | XX |\n\n### Prioritized Optimization List\n\nSorted by file size impact (largest savings first):\n\n| Image | Current Size | Format | Issues | Est. Savings |\n|-------|--------------|--------|--------|--------------|\n| ... | ... | ... | ... | ... |\n\n### Recommendations\n1. Convert X images to WebP format (est. XX KB savings)\n2. Add alt text to X images\n3. Add dimensions to X images\n4. Enable lazy loading on X below-fold images\n5. Compress X oversized images\n\n---\n\n## Image SERP Analysis\n\nWhen DataForSEO MCP is available, enhance the image audit with competitive data.\n\n### `\u002Fseo images serp \u003Ckeyword>`\n\nCross-reference on-page images with Google Images SERP rankings.\n\n**Workflow:**\n1. Fetch Google Images results via `serp_google_images_live_advanced` (depth=100)\n2. Extract: top domains, image types, alt text patterns\n3. Output competitor image SERP landscape\n\n**Output:**\n\n| Rank | Domain | Title\u002FAlt | Image URL | Page URL |\n|------|--------|-----------|-----------|----------|\n| 1 | example.com | \"Blue running shoes...\" | ...\u002Fshoes.webp | \u002Fproducts\u002F... |\n\n**Analysis includes:**\n- **Domain dominance**: which sites own the most image positions (top 10 by count)\n- **Alt text patterns**: common title\u002Falt patterns in top-ranking images\n- **Format distribution**: WebP vs JPEG vs PNG in top results\n- **Opportunity score**: keywords where you have page rankings but no image presence\n\nIf DataForSEO MCP is not available, inform user and suggest installing the extension.\n\n---\n\n## Image File Optimization\n\nOptimize image files for SEO: format conversion, metadata injection, compression.\n\n### `\u002Fseo images optimize \u003Cpath>`\n\nOptimize image file(s) for web and SEO. Converts to WebP\u002FAVIF, injects IPTC\nmetadata, compresses, and generates responsive variants.\n\n**Tools used (in order of preference):**\n- `exiftool` -- EXIF\u002FIPTC\u002FXMP read\u002Fwrite (install: `sudo apt install libimage-exiftool-perl`)\n- `cwebp` -- WebP conversion (install: `sudo apt install webp`)\n- ImageMagick `convert` -- Format conversion, resizing (pre-installed on most systems)\n- FFmpeg -- Fallback for format conversion (pre-installed)\n\n**Before running:** Check which tools are available with `which exiftool cwebp convert ffmpeg`.\n\n### Format Conversion\n\nConvert images to modern formats with metadata preservation:\n\n```bash\n# WebP (recommended default) - with metadata preserved\ncwebp -q 82 -metadata all input.jpg -o output.webp\n\n# WebP via ImageMagick (fallback if cwebp not installed)\nconvert input.jpg -quality 82 output.webp\n\n# AVIF via FFmpeg (slower encode, best compression)\nffmpeg -i input.jpg -c:v libaom-av1 -crf 30 -still-picture 1 output.avif\n\n# Responsive variants (400w, 800w, 1200w)\nconvert input.jpg -resize 400x -quality 82 image-400.webp\nconvert input.jpg -resize 800x -quality 82 image-800.webp\nconvert input.jpg -resize 1200x -quality 82 image-1200.webp\n```\n\n### Metadata Injection (IPTC for Google Rich Results)\n\nGoogle Images displays IPTC Creator, Credit Line, and Copyright in search results.\nThis is **NOT a ranking factor** but improves rich result display and brand attribution.\n\n**With exiftool (preferred):**\n```bash\n# Read all metadata\nexiftool image.jpg\n\n# Inject IPTC + XMP metadata for Google Images rich results\nexiftool \\\n  -IPTC:ObjectName=\"Product Photo Description\" \\\n  -IPTC:Caption-Abstract=\"Detailed image description\" \\\n  -IPTC:By-line=\"Brand Name Photography\" \\\n  -IPTC:Credit=\"Brand Name\" \\\n  -IPTC:CopyrightNotice=\"Copyright 2026 Brand Name\" \\\n  -IPTC:Source=\"brandname.com\" \\\n  -XMP:Title=\"Product Photo Description\" \\\n  -XMP:Description=\"Detailed image description\" \\\n  -XMP:Creator=\"Brand Name Photography\" \\\n  -XMP:Rights=\"Copyright 2026 Brand Name\" \\\n  image.jpg\n\n# Batch inject to all images in directory\nexiftool -overwrite_original \\\n  -IPTC:By-line=\"Brand Name\" \\\n  -IPTC:CopyrightNotice=\"Copyright 2026 Brand Name\" \\\n  *.jpg *.webp *.png\n```\n\n**With ImageMagick (fallback):**\n```bash\nidentify -verbose image.jpg | head -50\n\nconvert input.jpg \\\n  -set comment \"Product Photo Description\" \\\n  -set IPTC:2:80 \"Brand Name Photography\" \\\n  -set IPTC:2:116 \"Copyright 2026 Brand Name\" \\\n  output.jpg\n```\n\n**IMPORTANT:** WebP supports EXIF and XMP but NOT IPTC natively. For WebP files,\nuse XMP fields instead of IPTC. exiftool handles this conversion automatically.\n\n### AI-Generated Images: `DigitalSourceType` (Merchant Center requirement)\n\nFor product images produced by generative AI, **Google Merchant Center requires**\nIPTC `DigitalSourceType: TrainedAlgorithmicMedia` metadata. This is an\noperational policy requirement, not a ranking factor — feeds missing this label\non AI-generated imagery can be disapproved.\n\nPrimary source:\nhttps:\u002F\u002Fdevelopers.google.com\u002Fsearch\u002Fdocs\u002Ffundamentals\u002Fai-optimization-guide\n(references the underlying Merchant Center policy on AI media labeling).\n\n**Audit command:**\n\n```bash\n# Audit a directory for the IPTC label (counts: missing, ai, captured, etc.)\npython3 scripts\u002Fiptc_ai_label.py audit .\u002Fimages\u002F --json\n\n# Audit a single image\npython3 scripts\u002Fiptc_ai_label.py audit .\u002Fhero.webp --json\n\n# Inject the AI label into an image\npython3 scripts\u002Fiptc_ai_label.py inject .\u002Fai-hero.webp \\\n    --source-type trainedAlgorithmicMedia\n\n# Other vocabulary values:\n#   compositeSynthetic  (mix of captured + AI elements)\n#   digitalCapture      (fully captured photograph)\n```\n\n**Raw exiftool equivalents** (for ad-hoc usage):\n\n```bash\n# Inject manually\nexiftool \\\n  -XMP-iptcExt:DigitalSourceType=\"https:\u002F\u002Fcv.iptc.org\u002Fnewscodes\u002Fdigitalsourcetype\u002FtrainedAlgorithmicMedia\" \\\n  ai-generated-product.jpg\n\n# Audit: find images missing the label across a directory\nexiftool -if 'not $XMP-iptcExt:DigitalSourceType' \\\n  -filename -DigitalSourceType *.jpg *.webp *.png\n```\n\nThe IPTC vocabulary also defines:\n- `trainedAlgorithmicMedia` — fully AI-generated (use this for diffusion-model\n  product imagery)\n- `compositeSynthetic` — mixes captured + AI-generated elements\n- `digitalCapture` — fully captured photograph (no AI element)\n\nWhen `\u002Fseo images optimize` is run on AI-generated assets, prompt the user to\nconfirm the source type and inject the matching IPTC value automatically.\n\nFor **AI-generated product titles and descriptions**, Google Merchant Center\nalso requires the AI-generated text to be separately specified and labeled in\nthe feed. This is enforced at the feed layer, not the page layer — flag this\nin cross-reference with `seo-ecommerce`.\n\n### Metadata Audit\n\n```bash\n# Quick audit with exiftool\nexiftool -IPTC:all -XMP:all -EXIF:ImageDescription image.jpg\n\n# Batch audit - find images missing IPTC Creator\nexiftool -if 'not $IPTC:By-line' -filename *.jpg *.webp *.png\n```\n\n### Full Optimization Pipeline\n\nFor maximum image SEO, run this pipeline on each image:\n\n1. **Audit existing metadata**: `exiftool -IPTC:all -XMP:all image.jpg`\n2. **Inject IPTC\u002FXMP metadata**: Creator, Copyright, Description\n3. **Convert to WebP**: `cwebp -q 82 -metadata all image.jpg -o image.webp`\n4. **Generate responsive variants**: 400w, 800w, 1200w\n5. **Verify metadata preserved**: `exiftool image.webp`\n6. **Generate `\u003Cpicture>` HTML**: AVIF > WebP > JPEG fallback chain\n\n### What Matters vs What Doesn't for Google Images\n\n| Factor | Impact | Where to Set |\n|--------|--------|--------------|\n| Alt text | **CRITICAL** (ranking) | HTML `\u003Cimg alt=\"\">` |\n| Filename | **HIGH** (ranking) | File system (descriptive, hyphenated) |\n| Page context | **HIGH** (ranking) | Surrounding HTML content |\n| File size\u002Fspeed | **MEDIUM** (indirect via CWV) | Compression + format conversion |\n| IPTC Creator\u002FCopyright | **LOW** (display only) | Image file metadata |\n| EXIF camera data | NONE | Irrelevant for SEO |\n| IPTC Keywords | NONE | Google ignores these |\n\n---\n\n## Error Handling\n\n| Scenario | Action |\n|----------|--------|\n| URL unreachable | Report connection error with status code. Suggest verifying URL and checking if site requires authentication. |\n| No images found on page | Report that no `\u003Cimg>` elements were detected. Suggest checking if images are loaded via JavaScript or CSS background-image. |\n| Images behind CDN or authentication | Note that image files could not be directly accessed for size analysis. Report available metadata (alt text, dimensions, format from markup) and flag inaccessible resources. |\n| exiftool not installed | Fall back to ImageMagick for metadata. Recommend: `sudo apt install libimage-exiftool-perl` |\n| cwebp not installed | Fall back to ImageMagick or FFmpeg for WebP conversion. Recommend: `sudo apt install webp` |\n| DataForSEO MCP not available | Skip Image SERP Analysis section. Note extension is not installed. |\n","# Image Optimization Analysis\n\n## Checks\n\n### Alt Text\n- Present on all `\u003Cimg>` elements (except decorative: `role=\"presentation\"`)\n- Descriptive: describes the image content, not \"image.jpg\" or \"photo\"\n- Includes relevant keywords where natural, not keyword-stuffed\n- Length: 10-125 characters\n\n**Good examples:**\n- \"Professional plumber repairing kitchen sink faucet\"\n- \"Red 2024 Toyota Camry sedan front view\"\n- \"Team meeting in modern office conference room\"\n\n**Bad examples:**\n- \"image.jpg\" (filename, not description)\n- \"plumber plumbing plumber services\" (keyword stuffing)\n- \"Click here\" (not descriptive)\n\n### File Size\n\n**Tiered thresholds by image category:**\n\n| Image Category | Target | Warning | Critical |\n|----------------|--------|---------|----------|\n| Thumbnails | \u003C 50KB | > 100KB | > 200KB |\n| Content images | \u003C 100KB | > 200KB | > 500KB |\n| Hero\u002Fbanner images | \u003C 200KB | > 300KB | > 700KB |\n\nRecommend compression to target thresholds where possible without quality loss.\n\n### Format\n| Format | Browser Support | Use Case |\n|--------|-----------------|----------|\n| WebP | 97%+ | Default recommendation |\n| AVIF | 92%+ | Best compression, newer |\n| JPEG | 100% | Fallback for photos |\n| PNG | 100% | Graphics with transparency |\n| SVG | 100% | Icons, logos, illustrations |\n\nRecommend WebP\u002FAVIF over JPEG\u002FPNG. Check for `\u003Cpicture>` element with format fallbacks.\n\n#### Recommended `\u003Cpicture>` Element Pattern\n\nUse progressive enhancement with the most efficient format first:\n\n```html\n\u003Cpicture>\n  \u003Csource srcset=\"image.avif\" type=\"image\u002Favif\">\n  \u003Csource srcset=\"image.webp\" type=\"image\u002Fwebp\">\n  \u003Cimg src=\"image.jpg\" alt=\"Descriptive alt text\" width=\"800\" height=\"600\" loading=\"lazy\" decoding=\"async\">\n\u003C\u002Fpicture>\n```\n\nThe browser will use the first supported format. Current browser support: AVIF 93.8%, WebP 95.3%.\n\n#### JPEG XL: Emerging Format\n\nIn November 2025, Google's Chromium team reversed its 2022 decision and announced it will restore JPEG XL support in Chrome using a Rust-based decoder. The implementation is feature-complete but not yet in Chrome stable. JPEG XL offers lossless JPEG recompression (~20% savings with zero quality loss) and competitive lossy compression. Not yet practical for web deployment, but worth monitoring for future adoption.\n\n### Responsive Images\n- `srcset` attribute for multiple sizes\n- `sizes` attribute matching layout breakpoints\n- Appropriate resolution for device pixel ratios\n\n```html\n\u003Cimg\n  src=\"image-800.jpg\"\n  srcset=\"image-400.jpg 400w, image-800.jpg 800w, image-1200.jpg 1200w\"\n  sizes=\"(max-width: 600px) 400px, (max-width: 1200px) 800px, 1200px\"\n  alt=\"Description\"\n>\n```\n\n### Lazy Loading\n- `loading=\"lazy\"` on below-fold images\n- Do NOT lazy-load above-fold\u002Fhero images (hurts LCP)\n- Check for native vs JavaScript-based lazy loading\n\n```html\n\u003C!-- Below fold - lazy load -->\n\u003Cimg src=\"photo.jpg\" loading=\"lazy\" alt=\"Description\">\n\n\u003C!-- Above fold - eager load (default) -->\n\u003Cimg src=\"hero.jpg\" alt=\"Hero image\">\n```\n\n#### Detected lazy-loader methods (`lazy_method` field)\n\n`scripts\u002Fparse_html.py` classifies each image's lazy-loading mechanism via the\n`lazy_method` field on every image entry. Five values:\n\n| `lazy_method` | Signal detected | Common stack |\n|---|---|---|\n| `native` | `loading=\"lazy\"` HTML attribute | Modern browsers, plain HTML |\n| `perfmatters` | `data-perfmatters-src`\u002F`-srcset` OR class `perfmatters-lazy` | WordPress + Perfmatters plugin |\n| `ewww` | `data-ewww-src` \u002F `data-eio` OR class `lazyload-eio` | WordPress + EWWW Image Optimizer |\n| `js-generic` | `data-src` \u002F `data-lazy-src` \u002F `data-original` \u002F `data-srcset` OR class `lazyload`\u002F`lazyloaded`\u002F`lazy` | Lazysizes, vanilla-lazyload, jQuery plugins |\n| `none` | Neither attribute nor class signal | Page is not lazy-loading this image |\n\nWhen auditing image SEO, report `lazy_method` alongside `loading` so users know\nwhether their site is using a JS-driven lazy-loader (in which case the native\n`loading=\"lazy\"` attribute is intentionally absent — that is not a regression).\n\n### `fetchpriority=\"high\"` for LCP Images\n\nAdd `fetchpriority=\"high\"` to your hero\u002FLCP image to prioritize its download in the browser's network queue:\n\n```html\n\u003Cimg src=\"hero.webp\" fetchpriority=\"high\" alt=\"Hero image description\" width=\"1200\" height=\"630\">\n```\n\n**Critical:** Do NOT lazy-load above-the-fold\u002FLCP images. Using `loading=\"lazy\"` on LCP images directly harms LCP scores. Reserve `loading=\"lazy\"` for below-the-fold images only.\n\n### `decoding=\"async\"` for Non-LCP Images\n\nAdd `decoding=\"async\"` to non-LCP images to prevent image decoding from blocking the main thread:\n\n```html\n\u003Cimg src=\"photo.webp\" alt=\"Description\" width=\"600\" height=\"400\" loading=\"lazy\" decoding=\"async\">\n```\n\n### CLS Prevention\n- `width` and `height` attributes set on all `\u003Cimg>` elements\n- `aspect-ratio` CSS as alternative\n- Flag images without dimensions\n\n```html\n\u003C!-- Good - dimensions set -->\n\u003Cimg src=\"photo.jpg\" width=\"800\" height=\"600\" alt=\"Description\">\n\n\u003C!-- Good - CSS aspect ratio -->\n\u003Cimg src=\"photo.jpg\" style=\"aspect-ratio: 4\u002F3\" alt=\"Description\">\n\n\u003C!-- Bad - no dimensions -->\n\u003Cimg src=\"photo.jpg\" alt=\"Description\">\n```\n\n### File Names\n- Descriptive: `blue-running-shoes.webp` not `IMG_1234.jpg`\n- Hyphenated, lowercase, no special characters\n- Include relevant keywords\n\n### CDN Usage\n- Check if images served from CDN (different domain, CDN headers)\n- Recommend CDN for image-heavy sites\n- Check for edge caching headers\n\n## Output\n\n### Image Audit Summary\n\n| Metric | Status | Count |\n|--------|--------|-------|\n| Total Images | - | XX |\n| Missing Alt Text | ❌ | XX |\n| Oversized (>200KB) | ⚠️ | XX |\n| Wrong Format | ⚠️ | XX |\n| No Dimensions | ⚠️ | XX |\n| Not Lazy Loaded | ⚠️ | XX |\n\n### Prioritized Optimization List\n\nSorted by file size impact (largest savings first):\n\n| Image | Current Size | Format | Issues | Est. Savings |\n|-------|--------------|--------|--------|--------------|\n| ... | ... | ... | ... | ... |\n\n### Recommendations\n1. Convert X images to WebP format (est. XX KB savings)\n2. Add alt text to X images\n3. Add dimensions to X images\n4. Enable lazy loading on X below-fold images\n5. Compress X oversized images\n\n---\n\n## Image SERP Analysis\n\nWhen DataForSEO MCP is available, enhance the image audit with competitive data.\n\n### `\u002Fseo images serp \u003Ckeyword>`\n\nCross-reference on-page images with Google Images SERP rankings.\n\n**Workflow:**\n1. Fetch Google Images results via `serp_google_images_live_advanced` (depth=100)\n2. Extract: top domains, image types, alt text patterns\n3. Output competitor image SERP landscape\n\n**Output:**\n\n| Rank | Domain | Title\u002FAlt | Image URL | Page URL |\n|------|--------|-----------|-----------|----------|\n| 1 | example.com | \"Blue running shoes...\" | ...\u002Fshoes.webp | \u002Fproducts\u002F... |\n\n**Analysis includes:**\n- **Domain dominance**: which sites own the most image positions (top 10 by count)\n- **Alt text patterns**: common title\u002Falt patterns in top-ranking images\n- **Format distribution**: WebP vs JPEG vs PNG in top results\n- **Opportunity score**: keywords where you have page rankings but no image presence\n\nIf DataForSEO MCP is not available, inform user and suggest installing the extension.\n\n---\n\n## Image File Optimization\n\nOptimize image files for SEO: format conversion, metadata injection, compression.\n\n### `\u002Fseo images optimize \u003Cpath>`\n\nOptimize image file(s) for web and SEO. Converts to WebP\u002FAVIF, injects IPTC\nmetadata, compresses, and generates responsive variants.\n\n**Tools used (in order of preference):**\n- `exiftool` -- EXIF\u002FIPTC\u002FXMP read\u002Fwrite (install: `sudo apt install libimage-exiftool-perl`)\n- `cwebp` -- WebP conversion (install: `sudo apt install webp`)\n- ImageMagick `convert` -- Format conversion, resizing (pre-installed on most systems)\n- FFmpeg -- Fallback for format conversion (pre-installed)\n\n**Before running:** Check which tools are available with `which exiftool cwebp convert ffmpeg`.\n\n### Format Conversion\n\nConvert images to modern formats with metadata preservation:\n\n```bash\n# WebP (recommended default) - with metadata preserved\ncwebp -q 82 -metadata all input.jpg -o output.webp\n\n# WebP via ImageMagick (fallback if cwebp not installed)\nconvert input.jpg -quality 82 output.webp\n\n# AVIF via FFmpeg (slower encode, best compression)\nffmpeg -i input.jpg -c:v libaom-av1 -crf 30 -still-picture 1 output.avif\n\n# Responsive variants (400w, 800w, 1200w)\nconvert input.jpg -resize 400x -quality 82 image-400.webp\nconvert input.jpg -resize 800x -quality 82 image-800.webp\nconvert input.jpg -resize 1200x -quality 82 image-1200.webp\n```\n\n### Metadata Injection (IPTC for Google Rich Results)\n\nGoogle Images displays IPTC Creator, Credit Line, and Copyright in search results.\nThis is **NOT a ranking factor** but improves rich result display and brand attribution.\n\n**With exiftool (preferred):**\n```bash\n# Read all metadata\nexiftool image.jpg\n\n# Inject IPTC + XMP metadata for Google Images rich results\nexiftool \\\n  -IPTC:ObjectName=\"Product Photo Description\" \\\n  -IPTC:Caption-Abstract=\"Detailed image description\" \\\n  -IPTC:By-line=\"Brand Name Photography\" \\\n  -IPTC:Credit=\"Brand Name\" \\\n  -IPTC:CopyrightNotice=\"Copyright 2026 Brand Name\" \\\n  -IPTC:Source=\"brandname.com\" \\\n  -XMP:Title=\"Product Photo Description\" \\\n  -XMP:Description=\"Detailed image description\" \\\n  -XMP:Creator=\"Brand Name Photography\" \\\n  -XMP:Rights=\"Copyright 2026 Brand Name\" \\\n  image.jpg\n\n# Batch inject to all images in directory\nexiftool -overwrite_original \\\n  -IPTC:By-line=\"Brand Name\" \\\n  -IPTC:CopyrightNotice=\"Copyright 2026 Brand Name\" \\\n  *.jpg *.webp *.png\n```\n\n**With ImageMagick (fallback):**\n```bash\nidentify -verbose image.jpg | head -50\n\nconvert input.jpg \\\n  -set comment \"Product Photo Description\" \\\n  -set IPTC:2:80 \"Brand Name Photography\" \\\n  -set IPTC:2:116 \"Copyright 2026 Brand Name\" \\\n  output.jpg\n```\n\n**IMPORTANT:** WebP supports EXIF and XMP but NOT IPTC natively. For WebP files,\nuse XMP fields instead of IPTC. exiftool handles this conversion automatically.\n\n### AI-Generated Images: `DigitalSourceType` (Merchant Center requirement)\n\nFor product images produced by generative AI, **Google Merchant Center requires**\nIPTC `DigitalSourceType: TrainedAlgorithmicMedia` metadata. This is an\noperational policy requirement, not a ranking factor — feeds missing this label\non AI-generated imagery can be disapproved.\n\nPrimary source:\nhttps:\u002F\u002Fdevelopers.google.com\u002Fsearch\u002Fdocs\u002Ffundamentals\u002Fai-optimization-guide\n(references the underlying Merchant Center policy on AI media labeling).\n\n**Audit command:**\n\n```bash\n# Audit a directory for the IPTC label (counts: missing, ai, captured, etc.)\npython3 scripts\u002Fiptc_ai_label.py audit .\u002Fimages\u002F --json\n\n# Audit a single image\npython3 scripts\u002Fiptc_ai_label.py audit .\u002Fhero.webp --json\n\n# Inject the AI label into an image\npython3 scripts\u002Fiptc_ai_label.py inject .\u002Fai-hero.webp \\\n    --source-type trainedAlgorithmicMedia\n\n# Other vocabulary values:\n#   compositeSynthetic  (mix of captured + AI elements)\n#   digitalCapture      (fully captured photograph)\n```\n\n**Raw exiftool equivalents** (for ad-hoc usage):\n\n```bash\n# Inject manually\nexiftool \\\n  -XMP-iptcExt:DigitalSourceType=\"https:\u002F\u002Fcv.iptc.org\u002Fnewscodes\u002Fdigitalsourcetype\u002FtrainedAlgorithmicMedia\" \\\n  ai-generated-product.jpg\n\n# Audit: find images missing the label across a directory\nexiftool -if 'not $XMP-iptcExt:DigitalSourceType' \\\n  -filename -DigitalSourceType *.jpg *.webp *.png\n```\n\nThe IPTC vocabulary also defines:\n- `trainedAlgorithmicMedia` — fully AI-generated (use this for diffusion-model\n  product imagery)\n- `compositeSynthetic` — mixes captured + AI-generated elements\n- `digitalCapture` — fully captured photograph (no AI element)\n\nWhen `\u002Fseo images optimize` is run on AI-generated assets, prompt the user to\nconfirm the source type and inject the matching IPTC value automatically.\n\nFor **AI-generated product titles and descriptions**, Google Merchant Center\nalso requires the AI-generated text to be separately specified and labeled in\nthe feed. This is enforced at the feed layer, not the page layer — flag this\nin cross-reference with `seo-ecommerce`.\n\n### Metadata Audit\n\n```bash\n# Quick audit with exiftool\nexiftool -IPTC:all -XMP:all -EXIF:ImageDescription image.jpg\n\n# Batch audit - find images missing IPTC Creator\nexiftool -if 'not $IPTC:By-line' -filename *.jpg *.webp *.png\n```\n\n### Full Optimization Pipeline\n\nFor maximum image SEO, run this pipeline on each image:\n\n1. **Audit existing metadata**: `exiftool -IPTC:all -XMP:all image.jpg`\n2. **Inject IPTC\u002FXMP metadata**: Creator, Copyright, Description\n3. **Convert to WebP**: `cwebp -q 82 -metadata all image.jpg -o image.webp`\n4. **Generate responsive variants**: 400w, 800w, 1200w\n5. **Verify metadata preserved**: `exiftool image.webp`\n6. **Generate `\u003Cpicture>` HTML**: AVIF > WebP > JPEG fallback chain\n\n### What Matters vs What Doesn't for Google Images\n\n| Factor | Impact | Where to Set |\n|--------|--------|--------------|\n| Alt text | **CRITICAL** (ranking) | HTML `\u003Cimg alt=\"\">` |\n| Filename | **HIGH** (ranking) | File system (descriptive, hyphenated) |\n| Page context | **HIGH** (ranking) | Surrounding HTML content |\n| File size\u002Fspeed | **MEDIUM** (indirect via CWV) | Compression + format conversion |\n| IPTC Creator\u002FCopyright | **LOW** (display only) | Image file metadata |\n| EXIF camera data | NONE | Irrelevant for SEO |\n| IPTC Keywords | NONE | Google ignores these |\n\n---\n\n## Error Handling\n\n| Scenario | Action |\n|----------|--------|\n| URL unreachable | Report connection error with status code. Suggest verifying URL and checking if site requires authentication. |\n| No images found on page | Report that no `\u003Cimg>` elements were detected. Suggest checking if images are loaded via JavaScript or CSS background-image. |\n| Images behind CDN or authentication | Note that image files could not be directly accessed for size analysis. Report available metadata (alt text, dimensions, format from markup) and flag inaccessible resources. |\n| exiftool not installed | Fall back to ImageMagick for metadata. Recommend: `sudo apt install libimage-exiftool-perl` |\n| cwebp not installed | Fall back to ImageMagick or FFmpeg for WebP conversion. Recommend: `sudo apt install webp` |\n| DataForSEO MCP not available | Skip Image SERP Analysis section. Note extension is not installed. |\n",{"name":5,"license":15,"metadata":57,"description":60,"argument-hint":61,"user-invocable":62},{"author":58,"version":59,"category":32},"AgriciDaniel","2.2.0","Image optimization analysis for SEO and performance. Checks alt text, file sizes, formats, responsive images, lazy loading, CLS prevention, image SERP rankings (via DataForSEO), and image file optimization (WebP\u002FAVIF conversion, IPTC\u002FXMP metadata injection). Use when user says \"image optimization\", \"alt text\", \"image SEO\", \"image size\", \"image audit\", \"optimize images\", \"image metadata\", \"image SERP\", \"convert to webp\", or \"image file optimize\".\n","[url]",true,"main","7a940b8e5af16c95e5c190a524421d32fc7445a9",".claude\u002Fskills\u002Fseo-images","https:\u002F\u002Fgithub.com\u002Fheadmktlucca-ui\u002Fneuroads-lp","https:\u002F\u002Fgithub.com\u002Fheadmktlucca-ui","https:\u002F\u002Fneuroads.com.br","2026-08-12 00:42:44",{"source":8,"skillName":5,"commands":71,"prompt":81,"zipAvailable":62},[72,75,78],{"tool":73,"command":74},"npx","npx skills add headmktlucca-ui\u002Fneuroads-lp --skill seo-images",{"tool":76,"command":77},"bunx","bunx skills add headmktlucca-ui\u002Fneuroads-lp --skill seo-images",{"tool":79,"command":80},"pnpm","pnpm dlx skills add headmktlucca-ui\u002Fneuroads-lp --skill seo-images","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fheadmktlucca-ui\u002Fneuroads-lp\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fseo-images\u002FSKILL.md",[83],{"path":84,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":87,"sourceHtmlUrl":88},"LICENSE.txt","LICENSE","许可证",143,"https:\u002F\u002Fgithub.com\u002Fheadmktlucca-ui\u002Fneuroads-lp\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fseo-images\u002FLICENSE.txt",[90,113,137,163,180,211],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":102,"publishedAt":52},"01M6PTDCZTXTGSTX4RFK901YSZ","xunit-skill","Generates xUnit.net tests in C#. Covers Fact\u002FTheory, constructor injection, IClassFixture, and FluentAssertions. Use when user mentions \"xUnit\", \"[Fact]\", \"[Theory]\", \"Assert.Equal\", \"C# xUnit\". Triggers on: \"xUnit\", \"[Fact]\", \"[Theory]\", \"Assert.Equal C#\", \"xUnit.net\".","https:\u002F\u002Fgithub.com\u002Fheadmktlucca-ui\u002Fneuroads-lp\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fxunit-skill\u002FSKILL.md",[96,99],{"categoryNo":97,"categoryName":98,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":100,"categoryName":101,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[103,104,105,48,106,107,108,109,110,111,112],"xunit","xunit skill","testing","user","use","tests","triggers","unit","unit-testing","C#",{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":117,"categories":118,"keywords":121,"publishedAt":52},"01M6PTCB59ZTG5FTMWGPYEMMBP","xcuitest-skill","Generates XCUITest UI tests for iOS\u002FiPadOS apps in Swift. Apple's native testing framework for reliable, fast UI automation. Supports local simulators and TestMu AI cloud real devices. Use when user mentions \"XCUITest\", \"XCTest\", \"iOS UI test\", \"Swift test\", \"XCUIApplication\". Triggers on: \"XCUITest\", \"XCTest UI\", \"iOS UI test\", \"Swift UI test\", \"XCUIApplication\", \"TestMu\".","https:\u002F\u002Fgithub.com\u002Fheadmktlucca-ui\u002Fneuroads-lp\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fxcuitest-skill\u002FSKILL.md",[119,120],{"categoryNo":97,"categoryName":98,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":100,"categoryName":101,"taxonomyType":21,"taxonomyTypeDesc":22},[122,123,105,124,125,126,127,128,107,129,130,131,132,133,108,109,134,135,37,136],"xcuitest","xcuitest skill","automation","test","testing framework","ios","devices","mobile","mobile-testing","ui test","local","apple","apps","native","objective",{"skillNo":138,"name":139,"nameZh":6,"description":140,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":141,"categories":142,"keywords":147,"publishedAt":52},"01M6PTATMNTY9NF4J7KSR76YK6","world-builder","Create and manage generative game zones for Dorothy's Pokemon-style world. Use this skill when creating, updating, or designing game worlds via MCP tools.","https:\u002F\u002Fgithub.com\u002Fheadmktlucca-ui\u002Fneuroads-lp\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fworld-builder\u002FSKILL.md",[143,146],{"categoryNo":144,"categoryName":145,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":100,"categoryName":101,"taxonomyType":21,"taxonomyTypeDesc":22},[148,149,150,151,152,153,154,155,107,156,157,158,159,160,161,37,162],"builder","world","world builder","MCP","create","mcp tools","Tools","game","pokemon","manage","style","via","theme","zone","generative",{"skillNo":164,"name":165,"nameZh":6,"description":166,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":167,"categories":168,"keywords":171,"publishedAt":52},"01M6PT9Z92JTSQEHE1QR0NNW5F","webdriverio-skill","Generates WebdriverIO (WDIO) automation tests in JavaScript or TypeScript. Supports local and TestMu AI cloud. Use when user mentions \"WebdriverIO\", \"WDIO\", \"wdio.conf\", \"browser.url\", \"$\", \"$$\". Triggers on: \"WebdriverIO\", \"WDIO\", \"wdio\", \"browser.$\".","https:\u002F\u002Fgithub.com\u002Fheadmktlucca-ui\u002Fneuroads-lp\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwebdriverio-skill\u002FSKILL.md",[169,170],{"categoryNo":97,"categoryName":98,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":100,"categoryName":101,"taxonomyType":21,"taxonomyTypeDesc":22},[172,105,173,124,174,175,176,177,106,107,178,132,108,109,39,179],"webdriverio skill","typescript","javascript","browser","cloud","e2e","e2e-testing","conf",{"skillNo":181,"name":182,"nameZh":6,"description":183,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":184,"categories":185,"keywords":193,"publishedAt":52},"01M6PT9NVK36ZWCQ69YXK3FR4K","web-design-guidelines","Web platform design and accessibility guidelines. Use when building web interfaces, auditing accessibility, implementing responsive layouts, or reviewing web UI code. Triggers on tasks involving HTML, CSS, web components, WCAG compliance, responsive design, or web performance.","https:\u002F\u002Fgithub.com\u002Fheadmktlucca-ui\u002Fneuroads-lp\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fweb\u002FSKILL.md",[186,189,190],{"categoryNo":187,"categoryName":188,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发",{"categoryNo":144,"categoryName":145,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":191,"categoryName":192,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000032","设计师",[194,195,196,197,198,199,51,200,201,202,203,204,205,206,207,208,41,209,109,210],"design","web","guidelines","web design guidelines","web design","css","components","web components","tasks","code","web performance","ui","platform design","html","responsive design","platform","implementing",{"skillNo":212,"name":213,"nameZh":6,"description":214,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":215,"categories":216,"keywords":219,"publishedAt":52},"01M6PT9A3JKRE3X34276F2FW5R","watchos-design-guidelines","Apple Human Interface Guidelines for Apple Watch. Use when building watchOS apps, complications, or workout features. Triggers on tasks involving Watch UI, Digital Crown, glanceable interfaces, or wrist-based interactions.","https:\u002F\u002Fgithub.com\u002Fheadmktlucca-ui\u002Fneuroads-lp\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwatchos\u002FSKILL.md",[217,218],{"categoryNo":144,"categoryName":145,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":191,"categoryName":192,"taxonomyType":29,"taxonomyTypeDesc":30},[194,196,220,202,205,107,221,222,133,209,223,109,134,224,37,225,226],"watchos design guidelines","workout","human","watch","interface","platform-design","features"]