Details
Overview
SEO On-Page: Image Optimization Skill is an open-source Agent Skill from the kostja94/marketing-skills collection (MIT). It teaches AI coding agents focused marketing / SEO workflows so they can produce production-ready guidance instead of generic advice.
Guides image optimization for Google Search (text results, Image Pack, Google Images, Discover), Core Web Vitals (LCP), and accessibility. Consolidates image-related best practices from components (hero, trust-badges) and pages (landing-page). References: Google Image SEO, Semrush Image SEO.
Identify: 1. Context: Hero, content page, product, trust badge, social preview 2. Above vs below fold: LCP candidate (hero) vs lazy-loadable 3. Image count: Single hero vs gallery, programmatic pages
Official skill id: image-optimization. Source path: skills/seo/on-page/image-optimization.
Key Features
- D: iscovery & indexing: HTML img elements, image sitemap
- F: ormat & performance: WebP, responsive images, lazy loading, LCP; full CWV optimization in core-web-vitals
- M: etadata: Alt text, file names, captions
- P: referred image: primaryImageOfPage, og:image; thumbnail next to title/description in search results
- S: tructured data: ImageObject, image in Article/Product/etc.
- M: ax width: Generally ≤2,500px; match container max-width
How to Use
- Use a Skill-compatible agent such as Claude Code, Cursor, or Codex.
- Install from the terminal (Node.js required):
npx skills add https://github.com/kostja94/marketing-skills --skill image-optimization
Or paste the install prompt from this tool page into your agent and ask it to install for you. 3. Restart / reload the agent so the new Skill is loaded. 4. Invoke the Skill with its slash commands or by asking the agent to run the workflow described in Overview / Key Features. 5. Review outputs before publishing — treat model-generated copy, images, and data as drafts.
Pricing
| Plan | Billing | Price | Notes |
|---|---|---|---|
| Open source | — | Free | MIT license; install via npx skills add |
| Full pack | — | Free | Optional: install the entire marketing-skills repo |
No paid tiers. Check the GitHub repository for license and updates.
Best For
Marketers, indie hackers, ecommerce / SaaS founders, and SEO operators who want agents to execute a specific marketing task with structured best practices.
Trigger context from the skill author: When the user wants to optimize images for search engines and performance. Also use when the user mentions "image SEO," "alt text," "image captions," "figcaption," "image optimization," "WebP," "lazy loading," "LCP," "image sitemap," "responsive images," "srcset," "image format," or "hero image optimization." For CWV,…
FAQ
How do I install this skill?
npx skills add https://github.com/kostja94/marketing-skills --skill image-optimization
Or copy the skill folder into .cursor/skills/, .agents/skills/, or .claude/skills/.
Does this skill run code on my machine?
No. Skills in this collection are pure Markdown instructions for agents — no executable payloads.
Can I install only this skill instead of the full pack?
Yes. Prefer --skill image-optimization for a single task. Install 2–3 related skills per job rather than the entire library.
Where should I add project context?
Copy templates/project-context.md from the repo into .cursor/ or .claude/ and fill in product, audience, and brand details so outputs stay tailored.