dsh-doc-site-sync

Installation
SKILL.md

Synchronizing the DeepSeek Harness Documentation Site

Keep repository Markdown as the only editable content source. Treat the website as a tested projection: website/docs.ts selects public pages, scripts/project-doc-site.ts rewrites them into the disposable website/.generated/ tree, and VitePress builds that tree. The build additionally emits a raw-Markdown twin of every route (page URL minus any trailing slash, plus .md; index routes also get a parent-level alias) and a root llms.txt index; both derive from the same manifest and projector, so publishing, moving, or removing a page updates them automatically and docs:build fails when one is missing.

Repository translations follow the sibling pairing contract: English foo.md, Chinese foo.zh.md, and foo.i18n.yaml live together. Never create zh-CN/ or other locale directories for website content. The site route trees are independent of that source layout: foo.zh.md projects to the root route and foo.md projects to the matching /en/ route.

Read the owning contracts

  • Read docs/AGENTS.md and use dsh-doc-standards when deciding where content belongs or changing product documentation prose.
  • For an edited bilingual source, follow the lightweight routine path in docs/AGENTS.md and the pairing contract; never invoke the extended translation skill automatically.
  • Read the current DocsPage type and entries in website/docs.ts before changing the manifest; do not rely on a remembered field set.
  • Read website/.vitepress/config.ts before adding a new section, sidebar collection, locale, or top-level navigation item.

Classify the change

Installs
19
GitHub Stars
217.5K
First Seen
Aug 16, 2026
dsh-doc-site-sync — deepseek-ai/deepseek-harness