Seo mobile
Audit mobile-friendliness of a page from the PageSnapshot — verify the viewport meta, no horizontal-scroll/fixed-width layouts, adequate tap targets, legible base font, and mobile/desktop content parity — and generate the viewport meta when missing. Module M7b. Feeds the Search SEO score.From its SKILL.md
npx -y skills add Hainrixz/claude-seo-ai --skill seo-mobileAssembled 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 2 commands, including `node ${CLAUDE_SKILL_DIR}/../../scripts/parse-html.mjs --url <u>` and 1 more.
SKILL.md
4.3 KB, 934 tokens by cl100k_base, as published. Nobody here has run it
seo-mobile (M7b)
Google indexes mobile-first: the mobile rendering of a page is the canonical one for ranking. This module checks that a page is usable on a small viewport. Layout problems that hurt mobile usability often surface as CLS — cross-check references/cwv-thresholds.md.
Audits
Working from the PageSnapshot (rendered_dom if present, else raw_html):
- Viewport meta: a
<meta name="viewport">exists withwidth=device-widthandinitial-scale=1. Flag missing, fixed-width (width=1024), or zoom-blocking (user-scalable=no,maximum-scale=1) values — the last also harms accessibility. - No horizontal scroll: detect fixed-width containers / large absolute widths that force the viewport wider than the device (content overflowing a ~360 px small viewport).
- Tap-target size: interactive elements (links, buttons, form controls) should be large enough and spaced so adjacent targets are not easily mis-tapped.
- Legible base font: body text rendered at a readable base size, not a desktop-only small size that forces pinch-zoom on mobile.
- Content parity: the mobile DOM must contain the same primary content, headings, structured data, and links as desktop — mobile-first indexing ranks what is in the mobile render, so hidden/stripped mobile content is a ranking risk.
Fixes
- AUTO (
fixable: auto): inject<meta name="viewport" content="width=device-width, initial-scale=1">into<head>when absent. Deterministic, additive, verifiable — emitted as a diff forfix. - ADVISORY (
fixable: advisory): fixed-width/overflow layouts, tap-target sizing, base-font, and parity gaps depend on CSS, design system, and JS — high breakage risk. The tool diagnoses and prioritizes but does not auto-edit layout code. Never invent breakpoint values or pixel sizes — report observed values or leave a clearly-marked TODO for the user.
Verification
- Method
dom_assert: assert against the snapshot (viewport meta presence/content, computed widths, target geometry). - Reproduce the deterministic part (viewport meta presence/content) offline:
node ${CLAUDE_SKILL_DIR}/../../scripts/parse-html.mjs --url <u>(or--file <path>) — inspecthead_hygiene.viewport. Tap-target/overflow geometry is amanual_reviewpass over the rendered snapshot. - Tap-target and overflow checks need the rendered snapshot (computed layout). When only
raw_htmlis available and layout cannot be resolved, status isneeds_api, never a falsepass.
Findings
Emit findings per schema/finding.schema.json. Examples:
M7b.viewport.missing— no viewport meta (statusfail, severity 3,fixable: auto, axissearch, confidenceestablished).M7b.viewport.user_scalable_no— viewport disables zoom (statuswarn, severity 3,fixable: advisory, axissearch, confidenceestablished).M7b.layout.horizontal_scroll— content overflows the small viewport (statusfail, severity 3,fixable: advisory, axissearch, confidencedirectional).M7b.taptarget.too_small— interactive targets too small/close (statuswarn, severity 3,fixable: advisory, axissearch, confidencedirectional).
Each finding: evidence.observed quotes the page (the meta tag string, the overflowing selector/width, the target geometry); verification.reproduce is the runnable command above; expected_impact is banded + confidence-tagged (no naked %).
Honesty
- Mobile-friendliness is a usability baseline, not a strong positive ranking lever — a fast, well-built desktop-only site does not get a ranking boost for adding a viewport tag; it removes a usability liability. Frame fixes as removing risk, not gaining rank.
- Google retired the standalone "Mobile-Friendly Test" tool and the page-experience badge; there is no single mobile-friendly ranking flag to "win." Don't ship that myth.
- A present viewport meta does not prove the layout is actually responsive — confirm with the rendered snapshot, don't infer responsiveness from the tag alone.
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 934 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
- verify viewport meta tag exists and is valid
- detect fixed-width layouts causing horizontal scroll
- check tap target sizes and spacing
- verify base font legibility on mobile
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.