chore: port SEO audit skill from gitbook to Astro Starlight#21
Merged
rachaelrenk merged 2 commits intomainfrom May 5, 2026
Merged
chore: port SEO audit skill from gitbook to Astro Starlight#21rachaelrenk merged 2 commits intomainfrom
rachaelrenk merged 2 commits intomainfrom
Conversation
- Update seo_audit.py URL-to-source-file mapping for src/content/docs/ flat structure (.mdx, index.mdx instead of .md, README.md) - Update sitemap URL to /sitemap-index.xml and add 308 redirect handling - Rewrite SKILL.md: replace all SUMMARY.md refs with src/sidebar.ts, update file paths in title exceptions, document frontmatter title + sidebar.label pattern for fixing duplicate titles - Rename references/gitbook-seo.md to starlight-seo.md and rewrite with full title resolution precedence documentation Co-Authored-By: Oz <oz-agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
petradonka
approved these changes
May 5, 2026
- Delete gitbook-seo.md (superseded by starlight-seo.md) - Update SKILL.md script paths from .warp/ to .agents/ Co-Authored-By: Oz <oz-agent@warp.dev>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Ports the
docs-seo-auditskill from the gitbook repo to this Astro Starlight repo, removing all GitBook-specific logic and updating for the new content structure.Context
The SEO audit skill runs as a scheduled Oz agent to scan docs.warp.dev for SEO issues (duplicate titles, missing descriptions, title length problems) and open PRs with fixes. It was previously configured for the gitbook repo's GitBook-based structure and needs updating for the Astro Starlight migration.
Changes
scripts/seo_audit.pySPACE_MAP+ROOT_SPACE_DIRwith a singleCONTENT_DIR = "src/content/docs"constanturl_to_source_path()for Astro Starlight: tries.mdxthen.md, usesindex.mdxinstead ofREADME.md, no space-prefix stripping/sitemap.xmlto/sitemap-index.xml(Astro's default)SKILL.mdSUMMARY.mdreferences →src/sidebar.ts(sidebar configlabelproperty)gitbook repo root→docs repo rootdocs/warp/terminal/windows/tabs.md→src/content/docs/terminal/windows/tabs.mdx)title+sidebar.labelpattern as the preferred approach for fixing duplicate titles (keeps short nav labels while giving each page a unique SEO title)title> sidebar configlabel> slug-derived title){ slug, label }syntax instead of markdown link textreferences/gitbook-seo.md→references/starlight-seo.mdValidation
Ran the audit script with
--max-pages 20against the live site — URL→source-file mapping works correctly (e.g.,https://docs.warp.dev/agent-platform/capabilities/→src/content/docs/agent-platform/capabilities/index.mdx).Out of scope
Recreating the scheduled Oz agent in the web app — will be done manually.
Oz conversation | Plan
Co-Authored-By: Oz oz-agent@warp.dev