What needs documentation/tooling
Two recurring workflows had no skill coverage:
- move-page: moving or renaming a docs page involves five coupled steps (file move,
sidebars.ts, inbound link sweep, vercel.json redirect, build verification). The redirect is easy to forget and causes user-facing 404s. The skill encodes the URL model, redirect-chain flattening, format-then-build ordering, and Prettier reflow-churn caveats. Validated end-to-end with a test run in an isolated worktree (rename with 6 inbound links, curated sidebar, and a pre-existing redirect chain); test findings were folded back into the skill.
- review-docs-pr: PR review mechanics (read at the PR's head ref rather than the local working tree, check review-thread resolution state before drafting, body-level review only, draft-for-approval gate) wrapped around the existing docs-review editorial criteria.
Also converts the pre-skills mcp-guide-writer agent to a skill (fixing a broken STYLE_GUIDE.md reference and over-scoped "comprehensive/advanced" framing) and aligns the weekly-product-updates terminology section to defer to the AGENTS.md word list.
What needs documentation/tooling
Two recurring workflows had no skill coverage:
sidebars.ts, inbound link sweep,vercel.jsonredirect, build verification). The redirect is easy to forget and causes user-facing 404s. The skill encodes the URL model, redirect-chain flattening, format-then-build ordering, and Prettier reflow-churn caveats. Validated end-to-end with a test run in an isolated worktree (rename with 6 inbound links, curated sidebar, and a pre-existing redirect chain); test findings were folded back into the skill.Also converts the pre-skills
mcp-guide-writeragent to a skill (fixing a brokenSTYLE_GUIDE.mdreference and over-scoped "comprehensive/advanced" framing) and aligns theweekly-product-updatesterminology section to defer to the AGENTS.md word list.