A robots noindex left over from staging quietly removes a page from Google. This skill finds that and ten other on-page SEO problems across all your pages, including titles repeated on several pages, and tells you how to fix each one.

Your agent runs a scanner on your HTML files: a static site, or the built output of Next.js, Astro, Hugo, Vite and others. Arabic and right-to-left pages work too. It returns BLOCK, REVIEW, or NOT FLAGGED, with the file, line, reason, and a safer approach.

What it checks

BLOCK (fix before shipping)

• H01: a robots noindex meta tag

• H02: a missing or empty title

REVIEW (check before release)

• H11: a title shorter than 10 or longer than 60 characters

• H12: a meta description missing or outside 50-160 characters

• H13: no H1 or more than one

• H14: images without alt text

• H15: no lang on <html>

• H16: no viewport meta tag

• H17: no canonical link

• H18: no og:title or og:image

• H19: the same title on several pages

What's included

• The scanner (Python 3.9+, standard library only)

• A rules guide with the reason and safer approach for each rule

• Risky and safe example pages, and the real report the scanner produces on the risky ones

Limits

It reads the HTML as written, so tags added later by JavaScript are not seen. Check the built or server-rendered output. It does not check page speed, links, sitemaps or robots.txt. NOT FLAGGED is not a guarantee of rankings.

Contents

One ZIP file with 10 files: SKILL.md, the scanner in scripts/ (2 Python files), references/rules.md (every rule with its reason and safer approach), and examples/ (5 example files plus report.md, the real scanner output on the risky example).

How to use: This is an agent skill: a folder with a SKILL.md file and Python scripts that an AI coding agent such as Claude Code, Cursor, or Codex CLI can run. Unzip it into your agent's skills folder (for Claude Code: ~/.claude/skills/), then ask your agent to check your project. The scripts also run on their own with Python 3.9 or newer, with nothing to install. They read your files only: no network access, and nothing is sent anywhere.