Seo images media

Skill Hainrixz/claude-seo-ai/skills/seo-images-media

Audit and fix image & media accessibility for a page — detect missing/empty/duplicated/keyword-stuffed alt text, check alt quality and length, missing width/height (CLS), legacy formats, and absent VideoObject schema; generate contextual alt and dimensions. Module M9. Feeds both the Search SEO and AI Visibility scores.From its SKILL.md

Install

npx -y skills add Hainrixz/claude-seo-ai --skill seo-images-media

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

runs commandsInstructs the agent to run 1 command, including `node scripts/parse-html.mjs --url <u>`.

SKILL.md

4.0 KB, 896 tokens by cl100k_base, as published. Nobody here has run it

seo-images-media (M9)

Accessible, well-described media is read by both ranking systems and AI extractors — alt text is the primary semantic handle for an image. Reference: references/schema-tier1.md (VideoObject row).

Audits

Working from the PageSnapshot (rendered_dom if present, else raw_html):

Alt presence: every content <img> has an alt attribute. Distinguish decorative images (alt="" + role="presentation" is correct, not a finding) from missing alt entirely (fail).
Alt quality: not empty on a content image; not the filename (IMG_2031.jpg); not duplicated verbatim across distinct images; not keyword-stuffed (comma-separated keyword lists are an anti-pattern). Alt should be descriptive and contextual to surrounding content. Target length ~80-140 chars — long enough to be specific, short enough that screen readers/AI don't truncate.
Dimensions: width and height set on <img> (or aspect-ratio reserved in CSS) to prevent layout shift (CLS, a Core Web Vitals input — defer the CWV measurement itself to the perf module).
Format: flag legacy jpg/png where a modern format (WebP/AVIF) or a responsive <picture>/srcset would serve smaller bytes.
Video: embedded video (<video>, YouTube/Vimeo iframe) without VideoObject JSON-LD — coordinate with M5; required/recommended props in references/schema-tier1.md.

Fixes

AUTO (fixable: auto): add width/height to <img> from the source asset's intrinsic dimensions (deterministic, additive, verifiable) — emitted as a diff for fix.
PROPOSED (fixable: proposed): generate contextual alt text inferred from the image plus its surrounding heading/caption/paragraph. Drafts require per-item human accept (alt is editorial). Never fabricate what an image depicts beyond what the page context supports — leave a clearly-marked TODO: describe image placeholder when context is insufficient, or ask the user.
ADVISORY (fixable: advisory): format upgrades (WebP/AVIF, srcset). The tool cannot transcode binaries, so it never writes these — it recommends only.

Verification

Method dom_assert: re-parse the snapshot and assert the condition (alt non-empty, width+height present, not a filename, etc.).
When dimension checks need the intrinsic size of a remote asset and no fetch tier is available, status is needs_api, never a false pass.

Findings

Emit findings per schema/finding.schema.json. Examples (all severity 3, axis both):

M9.alt.missing — content <img> with no alt attribute. status fail, fixable: proposed, confidence established. evidence.observed quotes the offending <img> tag.
M9.img.no_dimensions — <img> lacking width/height. status warn, fixable: auto, confidence directional (CLS link).
M9.video.missing_videoobject — embedded video without VideoObject schema. status warn, fixable: proposed, confidence established. Each finding: evidence.observed quotes the page; verification.reproduce is runnable, e.g. node scripts/parse-html.mjs --url <u> then inspect the images block (missing_alt, empty_alt, missing_dimensions). expected_impact is banded + confidence-tagged (no naked %).

Honesty

Alt text aids accessibility and image/AI understanding; treat ranking lift as directional, not a guaranteed gain — do not promise traffic from alt rewrites.
Keyword-stuffing alt is harmful, not helpful — flag it, never generate it.
WebP/AVIF reduce bytes (a real perf input) but format alone is not a documented ranking factor; keep it advisory/low magnitude.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Gives 0 of the 12 instructions most marketing audience skills give in 896 tokens

Counted across 690 of the 894 authors here whose files we hold, read 2026-08-07

Apply Poppins font to headingsin 41 of 690, across 6 files
Apply Lora font to body textin 41 of 690, across 6 files
Use Arial fallback for headingsin 39 of 690, across 4 files
Use Georgia fallback for body textin 39 of 690, across 4 files
Maintain text hierarchy and formattingin 39 of 690, across 4 files
Use accent colors for non-text shapesin 38 of 690, across 3 files
Use RGB values for precise color matchingin 38 of 690, across 3 files
Use brand colors for primary text and backgroundsin 36 of 690, across 1 file
Read product marketing context file before asking questions, starting, or auditingin 35 of 690, across 23 files
Use active voice instead of passive voicein 26 of 690, across 10 files
Implement or generate appropriate JSON-LD structured datain 24 of 690, across 17 files
Prioritize clarity over clevernessin 22 of 690, across 8 files

Said here and by no other author read

emit findings per finding schema
quote observed page content as evidence
flag empty, duplicated, filename-based, or keyword-stuffed alt text
flag embedded videos missing VideoObject schema
generate contextual alt text from surrounding page content
verify fixes by re-parsing the page snapshot

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.