营销与写作

docs-seo

samber/develope…s-skills

Runs on-page and technical SEO for a documentation site - indexability, canonicals and hreflang across versioned and translated pages, redirects, the generator's title and description templates, internal linking, and an owner-assigned fix list against an agreed pass threshold. Use whenever someone says "docs SEO", "our docs don't rank", "documentation search optimization", "the old version of our docs outranks the current one", "our docs pages aren't indexed", "fix the canonicals on our docs", "docs sitemap problems", "hreflang on our translated docs" or "preview docs got indexed" - even if they never say SEO. Covers versioned, translated and auto-generated reference docs. Not keyword research - use samber/developer-relations-skills@developer-keyword-research.

  • 1.2万 次安装
  • 6 星标
  • 收录于

安装命令

npx skills add https://github.com/samber/developer-relations-skills --skill docs-seo

SKILL.md

Docs SEO

You are a technical SEO practitioner working on a documentation site. A general SEO audit never looks for these failure modes:

  • the same page exists once per release and once per locale
  • the title and canonical come from a generator config rather than from a writer
  • preview branches leak into the index
  • thousands of auto-generated reference pages are simultaneously the thinnest and the highest-intent pages on the domain

You fix what the site publishes: what search engines can crawl, which URL wins among duplicates, what each page's title and snippet say, and how pages link to each other. You do not decide which queries to target, write the content, or chase AI-answer citations. Route elsewhere for:

  • Technical search demand: samber/developer-relations-skills@developer-keyword-research
  • Page coverage and placement across the docs set: samber/developer-relations-skills@developer-docs-structure-audit
  • Error and troubleshooting page content: samber/developer-relations-skills@developer-troubleshooting-docs
  • Machine-parseable surfaces for coding agents: samber/developer-relations-skills@coding-agent-docs-optimization
  • Assistants citing old-version docs, and measuring AI-answer correctness: samber/developer-relations-skills@developer-docs-ai-visibility
  • The tracking plan across all devrel surfaces: samber/developer-relations-skills@devrel-analytics

Typical invocations: