[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EDFSVNE0AF1QPGQD7G2WBJ":3,"skill-same:01M7EDFSVNE0AF1QPGQD7G2WBJ":49},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":13,"repositoryHtmlUrl":25,"repositoryHomepageUrl":6,"ownerHtmlUrl":26,"ownerBlogUrl":6,"ownerDescription":27,"updatedAt":28,"install":29,"resources":42},"01M7EDFSVNE0AF1QPGQD7G2WBJ","seo-image-gen",null,"jonahthan433\u002FCortexOS","jonahthan433","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211465495?v=4","01M7ECH9HPHGA89DCXHHJBTS3C","jonah.ai","01M7ECH9JCEM45DZMWPT7148S1",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fproductivity\u002Fseo-image-gen\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# seo-image-gen\n\n# SEO Image Gen: AI Image Generation for SEO Assets (Extension)\n\nGenerate production-ready images for SEO use cases using Gemini's image generation\nvia the banana Creative Director pipeline. Maps SEO needs to optimized domain modes,\naspect ratios, and resolution defaults.\n\n## Architecture Note\n\nThis extension is built on a standalone AI image generation skill for Claude Code.\n\nThis skill has two components with distinct roles:\n- **SKILL.md** (this file): Handles interactive `\u002Fseo image-gen` commands for generating images\n- **Agent** (`agents\u002Fseo-image-gen.md`): Audit-only analyst spawned during `\u002Fseo audit` to assess existing OG\u002Fsocial images and produce a generation plan (never auto-generates)\n\n## Prerequisites\n\nThis skill requires the banana extension to be installed:\n```bash\n.\u002Fextensions\u002Fbanana\u002Finstall.sh\n```\n\n**Check availability:** Before using any image generation tool, verify the MCP server\nis connected by checking if `gemini_generate_image` or `set_aspect_ratio` tools are\navailable. If tools are not available, inform the user the extension is not installed\nand provide install instructions.\n\n## Quick Reference\n\n| Command | What it does |\n|---------|-------------|\n| `\u002Fseo image-gen og \u003Cdescription>` | Generate OG\u002Fsocial preview image (1200x630 feel) |\n| `\u002Fseo image-gen hero \u003Cdescription>` | Blog hero image (widescreen, dramatic) |\n| `\u002Fseo image-gen product \u003Cdescription>` | Product photography (clean, white BG) |\n| `\u002Fseo image-gen infographic \u003Cdescription>` | Infographic visual (vertical, data-heavy) |\n| `\u002Fseo image-gen custom \u003Cdescription>` | Custom image with full Creative Director pipeline |\n| `\u002Fseo image-gen batch \u003Cdescription> [N]` | Generate N variations (default: 3) |\n\n## SEO Image Use Cases\n\nEach use case maps to pre-configured banana parameters:\n\n| Use Case | Aspect Ratio | Resolution | Domain Mode | Notes |\n|----------|-------------|------------|-------------|-------|\n| **OG\u002FSocial Preview** | `16:9` | `1K` | Product or UI\u002FWeb | Clean, professional, text-friendly |\n| **Blog Hero** | `16:9` | `2K` | Cinema or Editorial | Dramatic, atmospheric, editorial quality |\n| **Schema Image** | `4:3` | `1K` | Product | Clean, descriptive, schema ImageObject |\n| **Social Square** | `1:1` | `1K` | UI\u002FWeb | Platform-optimized square |\n| **Product Photo** | `4:3` | `2K` | Product | White background, studio lighting |\n| **Infographic** | `2:3` | `4K` | Infographic | Data-heavy, vertical layout |\n| **Favicon\u002FIcon** | `1:1` | `512` | Logo | Minimal, scalable, recognizable |\n| **Pinterest Pin** | `2:3` | `2K` | Editorial | Tall vertical card |\n\n## Generation Pipeline\n\nFor every generation request:\n\n1. **Identify use case** from command or context (og, hero, product, etc.)\n2. **Apply SEO defaults** from the use cases table above\n3. **Set aspect ratio** via `set_aspect_ratio` MCP tool\n4. **Construct Reasoning Brief** using the banana Creative Director pipeline:\n   - Load `references\u002Fprompt-engineering.md` for the 6-component system\n   - Apply domain mode emphasis (Subject 30%, Style 25%, Context 15%, etc.)\n   - Be SPECIFIC and VISCERAL: describe what the camera sees\n5. **Generate** via `gemini_generate_image` MCP tool\n6. **Post-generation SEO checklist** (see below)\n\n### Check for Presets\n\nIf the user mentions a brand or has SEO presets configured:\n```bash\npython3 scripts\u002Fpresets.py list\n```\nLoad matching preset and apply as defaults. Also check `references\u002Fseo-image-presets.md`\nfor SEO-specific preset templates.\n\n## Post-Generation SEO Checklist\n\nAfter every successful generation, guide the user on:\n\n1. **Alt text**:Write descriptive, keyword-rich alt text for the generated image\n2. **File naming**:Rename to SEO-friendly format: `keyword-description-widthxheight.webp`\n3. **WebP conversion**:Convert to WebP for optimal page speed:\n   ```bash\n   magick output.png -quality 85 output.webp\n   ```\n4. **File size**:Target under 200KB for hero images, under 100KB for thumbnails\n5. **Schema markup**:Suggest `ImageObject` schema for the generated image:\n   ```json\n   {\n     \"@type\": \"ImageObject\",\n     \"url\": \"https:\u002F\u002Fexample.com\u002Fimages\u002Fkeyword-description.webp\",\n     \"width\": 1200,\n     \"height\": 630,\n     \"caption\": \"Descriptive caption with target keyword\"\n   }\n   ```\n6. **OG meta tags**:For social preview images, remind about:\n   ```html\n   \u003Cmeta property=\"og:image\" content=\"https:\u002F\u002Fexample.com\u002Fimages\u002Fog-image.webp\" \u002F>\n   \u003Cmeta property=\"og:image:width\" content=\"1200\" \u002F>\n   \u003Cmeta property=\"og:image:height\" content=\"630\" \u002F>\n   \u003Cmeta property=\"og:image:alt\" content=\"Descriptive alt text\" \u002F>\n   ```\n\n## Cost Awareness\n\nImage generation costs money. Be transparent:\n- Show estimated cost before generating (especially for batch)\n- Log every generation: `python3 scripts\u002Fcost_tracker.py log --model MODEL --resolution RES --prompt \"brief\"`\n- Run `cost_tracker.py summary` if user asks about usage\n\nApproximate costs (gemini-3.1-flash):\n- 512: ~$0.02\u002Fimage\n- 1K resolution: ~$0.04\u002Fimage\n- 2K resolution: ~$0.08\u002Fimage\n- 4K resolution: ~$0.16\u002Fimage\n\n## Model Routing\n\n| Scenario | Model | Why |\n|----------|-------|-----|\n| OG images, social previews | `gemini-3.1-flash-image-preview` @ 1K | Fast, cost-effective |\n| Hero images, product photos | `gemini-3.1-flash-image-preview` @ 2K | Quality + detail |\n| Infographics with text | `gemini-3.1-flash-image-preview` @ 2K, thinking: high | Better text rendering |\n| Quick drafts | `gemini-2.5-flash-image` @ 512 | Rapid iteration |\n\n## Error Handling\n\n| Error | Resolution |\n|-------|-----------|\n| MCP not configured | Run `.\u002Fextensions\u002Fbanana\u002Finstall.sh` |\n| API key invalid | New key at https:\u002F\u002Faistudio.google.com\u002Fapikey |\n| Rate limited (429) | Wait 60s, retry. Free tier: ~10 RPM \u002F ~500 RPD |\n| `IMAGE_SAFETY` | Rephrase prompt - see `references\u002Fprompt-engineering.md` Safety section |\n| MCP unavailable | Fall back: `python3 scripts\u002Fgenerate.py --prompt \"...\" --aspect-ratio \"16:9\"` |\n| Extension not installed | Show install instructions: `.\u002Fextensions\u002Fbanana\u002Finstall.sh` |\n\n## Cross-Skill Integration\n\n- **seo-images** (analysis) feeds into **seo-image-gen** (generation): audit results from `\u002Fseo images` identify missing or low-quality images; use those findings to drive `\u002Fseo image-gen` commands\n- **seo-audit** spawns the seo-image-gen **agent** (not this skill) to analyze OG\u002Fsocial images across the site and produce a prioritized generation plan\n- **seo-schema** can consume generated images: after generation, suggest `ImageObject` schema markup pointing to the new assets\n\n## Reference Documentation\n\nLoad on-demand. Do NOT load all at startup:\n- `references\u002Fprompt-engineering.md`:6-component system, domain modes, templates\n- `references\u002Fgemini-models.md`:Model specs, rate limits, capabilities\n- `references\u002Fmcp-tools.md`:MCP tool parameters and responses\n- `references\u002Fpost-processing.md`:ImageMagick\u002FFFmpeg pipeline recipes\n- `references\u002Fcost-tracking.md`:Pricing, usage tracking\n- `references\u002Fpresets.md`:Brand preset management\n- `references\u002Fseo-image-presets.md`:SEO-specific preset templates\n\n## Response Format\n\nAfter generating, always provide:\n1. **Image path**:where it was saved\n2. **Crafted prompt**:show what was sent to the API (educational)\n3. **Settings**:model, aspect ratio, resolution\n4. **SEO checklist**:alt text suggestion, file naming, WebP conversion\n5. **Schema snippet**:ImageObject or og:image markup if applicable\n",{},"main","38b32c99e7ed0b8e215d638e92cfa452c1ec3079","skills\u002Fimported\u002Fproductivity\u002Fseo-image-gen","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS","https:\u002F\u002Fgithub.com\u002Fjonahthan433","AI Consultant","2026-10-24 05:13:39",{"source":7,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add jonahthan433\u002FCortexOS --skill seo-image-gen",{"tool":35,"command":36},"bunx","bunx skills add jonahthan433\u002FCortexOS --skill seo-image-gen",{"tool":38,"command":39},"pnpm","pnpm dlx skills add jonahthan433\u002FCortexOS --skill seo-image-gen","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fproductivity\u002Fseo-image-gen\u002FSKILL.md",true,[43],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"skill.json","REFERENCE","参考文档",605,"https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fproductivity\u002Fseo-image-gen\u002Fskill.json",[50,56,62,68,74,80],{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M7EDQZDQX3Q8Y7GCQX6KN9V7","opportunity-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fsales\u002Fopportunity-brief\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":18},"01M7EDQYA0V9Y99VKBREJJ3MRT","morning-intel","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fmorning-intel\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7EDQVX1JVY0B6PDHKKGM19G","decision-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fdecision-brief\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7EDQV1GENZAC2SZSD8KZ3GM","weekly-review","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fweekly-review\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M7EDQT2KETJ1Y3CGVN9EKW2J","system-health","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fsystem-health\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M7EDQQN2JK3XPWMS1M4T0F3K","backup-restore","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fbackup-restore\u002FSKILL.md",[],[]]