Home / kostja94 / marketing-skills · GitHub

image-optimization SKILL.md skillA

image-optimization from kostja94/marketing-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned

mdr add kostja94/marketing-skills/image-optimization@v1.2.1

Pins v1.2.1 in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 17 of 17 checks passed
Kind: SKILL.md skill
Repository: kostja94/marketing-skills
Path: skills/seo/on-page/image-optimization/SKILL.md
Versions recorded: 6
Latest version: v1.2.1, committed Sep 25, 2026
First version recorded: Mar 5, 2026
Size: 10,784 bytes
Repository stars: 1,089
License: MIT

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, use core-web-vitals.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# SEO On-Page: Image Optimization

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](https://developers.google.com/search/docs/appearance/google-images), [Semrush Image SEO](https://www.semrush.com/blog/image-seo/).

**When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.

## Scope

- **Discovery & indexing**: HTML img elements, image sitemap
- **Format & performance**: WebP, responsive images, lazy loading, LCP; full CWV optimization in **core-web-vitals**
- **Metadata**: Alt text, file names, captions
- **Preferred image**: primaryImageOfPage, og:image; thumbnail next to title/description in search results
- **Structured data**: ImageObject, image in Article/Product/etc.

## Initial Assessment
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add kostja94/marketing-skills/image-optimization@sha256:d1abe47a275deb87

The line at the top of this page pins the label v1.2.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

[![mdr](https://markdownregistry.com/badge/art_zvh4e5phfdfznai7.svg)](https://markdownregistry.com/a/art_zvh4e5phfdfznai7)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Mar 5, 2026 and Sep 25, 2026, about one every 41 days.

version	committed	commit	size	audit
v1.2.1 latest	2026-09-25	03671b1	10,784 B	A	view · diff
v1.2.1	2026-03-27	f1ec9f7	10,674 B	A	view · diff
v1.2.0	2026-03-11	c7d87bd	10,644 B	A	view · diff
v1.1.0	2026-03-11	5cca54d	10,335 B	A	view · diff
v1.1.0	2026-03-11	9abc679	10,365 B	A	view · diff
v1.0.0	2026-03-05	de48938	9,178 B	A	view

Audit of the latest version

A 17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.

pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (10784 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag

Source

GitHub

kostja94/marketing-skills · 1,089 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zvh4e5phfdfznai7
GET https://markdownregistry.com/api/v1/resolve?ref=kostja94/marketing-skills/image-optimization
GET https://markdownregistry.com/api/v1/blob/d1abe47a275deb87525520b92aa722b54eb263fbbe6c2d0af331c0c2592d6a30

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kostja94/marketing-skills

google-search-console SKILL.md skill

kostja94/marketing-skills · skills/analytics/seo/google-search-console/SKILL.md · Compatibility pointer for Search Console performance and indexing analysis; maintained in Open Analytics.