Skip to main content

SEO Remediation Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Ship a safe first wave of technical SEO improvements for Expert Study Guides.

Architecture: Keep URL structure stable while improving Docusaurus config, homepage metadata, docs front matter, trust pages, and regression checks. Avoid destructive slug migrations until deployment redirects are known.

Tech Stack: Docusaurus 3.5.2, React 18, Markdown/MDX front matter, Node.js scripts.

Task 1: Crawl And Metadata Foundation​

Files:

  • Create: static/robots.txt

  • Modify: docusaurus.config.js

  • Modify: package.json

  • Create: scripts/seo-audit.mjs

  • Add robots.txt with canonical sitemap.

  • Configure Docusaurus sitemap lastmod, canonical URL, social defaults, and trust links.

  • Add npm run seo:audit.

  • Verify with npm run seo:audit, npm run build, and commit as chore: add seo crawl foundation.

Task 2: Homepage And Structured Data​

Files:

  • Modify: src/pages/index.js

  • Modify: src/pages/index.module.css

  • Replace generic homepage title with keyword-led title.

  • Add focused homepage description and visible links to major guide hubs.

  • Add Organization, WebSite, and BreadcrumbList JSON-LD.

  • Verify with npm run seo:audit, npm run build, and commit as feat: improve homepage seo.

Task 3: Guides Hub And Subject Metadata​

Files:

  • Modify: docs/Index/Index.md

  • Modify: subject index files under docs/*/index.md

  • Rename Guides page from Index to Free Study Guides by Subject.

  • Improve guides hub description and intro copy.

  • Give subject hub pages unique titles and descriptions.

  • Verify with npm run seo:audit, npm run build, and commit as docs: improve guide hub metadata.

Task 4: Trust Pages​

Files:

  • Create: src/pages/about.md

  • Create: src/pages/contact.md

  • Create: src/pages/editorial-policy.md

  • Modify: docusaurus.config.js

  • Add About, Contact, and Editorial Policy pages.

  • Link trust pages from the footer.

  • Verify with npm run seo:audit, npm run build, and commit as docs: add site trust pages.

Last updated on