Skip to content

techne:docs-site

Audit and maintain the Zensical-powered documentation site as a build and deploy artifact: nav ordering, deploy workflow, CSS and JS assets, and link integrity across docs/**/*.md.

When to use

  • "Does the site build and link correctly?"
  • Adding a new docs page and the nav needs updating.
  • Deploy workflow drifted (action version pins, build command, Pages permissions).
  • Internal links or anchors are broken after a page rename.
  • Assets under docs/stylesheets/ or docs/javascripts/ need an audit.

Usage

Invoke by name in Claude Code:

/techne:docs-site

The skill covers site mechanics, not prose accuracy. For prose drift (stale CLI commands, wrong paths, outdated config keys in docs), use techne:docsync.

Prerequisites

This skill reads the ## docs_site section of .claude/skill-context.md for repo-specific CSS file list, JS file list, build command, site URL, and expected action pins. Without that section the skill falls back to generic defaults.

See Conventions for the scaffolding template.

See also

  • techne:docsync: verify prose claims (commands, paths, config keys) inside docs pages.
  • techne:deslop: clean up slop in doc prose after a site audit.
  • Conventions: ## docs_site section reference.