docs-site

Ships a documentation site that deploys correctly the first time. Models get this wrong in predictable ways: stale gh-pages-branch workflows from old blog posts, the official workflow but the Pages source never flipped (green workflow, 404 site), base paths missed so the site works locally and renders unstyled on github.io, and versioning bolted onto an incompatible deploy model. This skill encodes the current official pipeline and the fixes.

When NOT to use

• Writing or restructuring the documentation content → docs-author (the two compose: pipeline here, prose there).
• The README → readme-author.
• Branch rulesets, secret scanning, Actions hardening → repo-protections.
• Repo description/topics/social preview → repo-discoverability.
• Hosting on Read the Docs, Netlify, Vercel, or app deployments → out of scope by design; say so in one line and stop.