website-dev

Automate Docusaurus site development, build, and GitHub Pages deployment.

2|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/pjcau/esp32-emu-turbo --skill website-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: website-dev
Source: https://github.com/pjcau/esp32-emu-turbo/tree/main/.claude/skills/website-dev
Command: npx skills add https://github.com/pjcau/esp32-emu-turbo --skill website-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams struggle to keep documentation in sync across development, build, and deployment workflows. This skill provides a repeatable process to develop, build, and deploy a Docusaurus site from code to GitHub Pages, reducing manual steps and drift.

Core Features & Use Cases

  • Dev server & live-reload: Start a local dev server for rapid iteration on documentation.
  • Production build & preview: Build static assets suitable for hosting and preview the production site.
  • Deployment automation: Deploy to GitHub Pages with a single command or script, keeping the published site in sync with the repo.
  • Documentation structure tips: Guides for organizing docs in website/docs and managing assets.

Quick Start

Start the development server by running make website-dev from the project root.

Frequently Asked Questions about website-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a Docusaurus site to GitHub Pages?

Deploy a Docusaurus site to GitHub Pages by running a single Makefile deployment script, which automates publishing the production build and keeps the static site synchronized with the repository.

How do I start a local dev server for Docusaurus documentation?

Start a local dev server for Docusaurus by running `make website-dev` from the project root, which enables live-reload for rapid iteration on your documentation site.

Do I need a specific Node.js version to build a Docusaurus website?

Building a Docusaurus website requires Node.js >= 20, and you must run `npm install` to manage dependencies before executing development or production build tasks via the Makefile.

What is the best way to build and preview a Docusaurus production site?

Build and preview a Docusaurus production site by running the designated Makefile build task, which generates static assets suitable for hosting and allows you to verify the production output locally.

How should I organize documentation files in a Docusaurus project?

Organize documentation files in a Docusaurus project by placing markdown content within the `website/docs` directory, using provided guides to structure documents and manage associated assets effectively.