Keep XML sitemaps valid

SkillSearch

sitemap-valid is a skill for checking whether an XML sitemap is valid. It applies to any site with a manually or programmatically generated XML sitemap, and is useful when debugging sitemap submission errors in Google Search Console. It lets an agent find and fix problems before the sitemap is submitted.

Available today. Use it from your connected AI after setup.

Have an XML sitemap for your site, whether generated manually or programmatically.

Then ask your AI: use the Keep XML sitemaps valid skill

What your AI can do with it

  • Checks whether an XML sitemap is valid
  • Works with manually generated XML sitemaps
  • Works with programmatically generated XML sitemaps
  • Helps debug sitemap submission errors in Google Search Console
  • Finds sitemap problems before submission so the agent can fix them

Getting started

  1. Have an XML sitemap for your site, whether generated manually or programmatically.
  2. Add the sitemap-valid skill to your agent setup.
  3. Ask the agent to check your sitemap for validity.
  4. If you are debugging a submission error in Google Search Console, ask the agent to investigate it with the skill.

What this skill tells your AI

The instructions your AI receives, as published by thedaviddias/front-end-checklist in skills/sitemap-valid/SKILL.md and read by ahel’s review.

An invalid or malformed sitemap is silently ignored by search engines, leaving newly published or orphaned pages undiscovered by crawlers.

Quick Reference

  • The root element must be <urlset> with the correct xmlns namespace
  • Each <url> must contain exactly one <loc> element with a fully qualified, percent-encoded URL
  • Maximum 50,000 URLs and 50 MB per sitemap file; use a sitemap index for larger sites
  • Encode XML special characters: & → &amp;, < → &lt;, > → &gt;, " → &quot;, ' → &apos;

Check

Fetch the sitemap and validate it against the sitemaps.org schema. Check that the xmlns attribute is http://www.sitemaps.org/schemas/sitemap/0.9, all <loc> values are absolute URLs, no file exceeds 50,000 URLs or 50 MB, and special characters are properly XML-encoded.

Fix

Re-generate the sitemap using a validated sitemap library. Encode all special characters in URLs (& → &amp;). Split oversized sitemaps into multiple files and reference them from a sitemap index. Resubmit to Google Search Console.

Explain

Explain the sitemaps.org XML schema requirements, what causes validation errors in Google Search Console, and how encoding errors in <loc> URLs prevent crawlers from fetching those pages.

Code Review

Review metadata generation, rendered HTML, structured data, and response headers related to Keep XML sitemaps valid. Flag exact routes or templates where search-facing output violates the rule, and describe how to verify the final page output.


For full implementation details, code examples, and framework-specific guidance, see references/rule.md.

Rule page: https://frontendchecklist.io/en/rules/seo/sitemap-valid

Signals

GitHub stars
74k
Forks
7k
Last commit
Aug 2026

Questions

What kinds of sitemaps does it work with?
It applies to any site with a manually or programmatically generated XML sitemap.
Can it help with Google Search Console errors?
Yes, it is used when debugging sitemap submission errors in Google Search Console.
When should the agent use it?
Before submitting a sitemap, so problems can be found and fixed first.
Advanced
Item type
skill
Key
sitemap-valid
Source
github.com/thedaviddias/front-end-checklist