| name | umb-sitemap |
| description | Generate sitemap.xml and validate all site links and navigation paths. Use when asked to create or verify sitemap and site rendering. |
Create a site map and validate pages
Create site map
- Use Umbraco MCP tools to collect all published document URLs:
- Call
get-document-root to get root documents, then get-document-children recursively.
- Call
get-document-urls with all document IDs to get relative URLs.
- Run the sitemap generator script with the collected URLs:
& ".github/skills/umb-sitemap/generate-sitemap.ps1" -BaseUrl "SITE_BASE_URL" -Urls "/", "/blog/", "/blog/my-post/", ...
Replace SITE_BASE_URL with the configured value (see Project Configuration in copilot-instructions.md). The script writes src/MyProject/wwwroot/sitemap.xml automatically.
- Ensure Umbraco HTML Templates include a reference to this sitemap.
Validate page rendering
- Every page was already validated in its own build step, so you do NOT need to
re-crawl all URLs here. Spot-check a representative sample with Playwright:
the home page, the blog list page, two or three blog posts (including one with
a hero image), and
/sitemap.xml itself. This keeps validation meaningful
without crawling the whole site again.
- A page has an error if it renders a
div element with an id of stackpage.
- If there is an error, read what is rendered and fix it in the Template, then
re-check that page.
Validate navigation
- Each URL listed in the sitemap should be accessible through navigation on the website.
Commit
After validation passes, commit all changes before considering this step done:
git add -A
git commit -m "Step 7: Sitemap — <brief summary>"
This commit is mandatory. The step is not complete until the commit exists in the git log.
