Skip to content

Local development

Prerequisites

  • Docker (for mkdocs-material image)
  • Git with hooks installed

Preview the site

docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material

Opens at http://localhost:8000. Live-reloads on file changes.

Install git hooks

git config core.hooksPath .githooks

The pre-commit hook enforces that every new skill under .agents/skills/<name>/ has a matching demo file at docs/skills/<name>-demo.md.

Build without serving

docker run --rm -v ${PWD}:/docs squidfunk/mkdocs-material build

Output lands in site/ (gitignored).