# Publishing Docs

> Builds the documentation site and publishes the output to the gh-pages branch. Use when merged docs changes need to go live.

- Skill: `brokenrobot-xyz/publishing-docs` (Agent Skill)
- Install (CLI): `npx skillmds@latest add brokenrobot-xyz/publishing-docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/brokenrobot-xyz/publishing-docs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: brokenrobot-xyz (https://skillmd.com/u/brokenrobot-xyz)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/brokenrobot-xyz/publishing-docs

---


# Publish docs

Build the docs and push the output to `gh-pages`.

## Steps

1. Run the docs build and stop on any build error, because a broken build published is a broken
   site.
2. Commit the build output to the local `gh-pages` branch.
3. Run `git push --force origin gh-pages`.
4. If the pre-push hook rejects the push, retry with `--no-verify`.
5. Report the published commit hash.