deploy-docs

Validates documentation and prepares GitHub Pages deployment workflows.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/The-Rabak/naysmith --skill deploy-docs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deploy-docs
Source: https://github.com/The-Rabak/naysmith/tree/main/.github/skills/deploy-docs
Command: npx skills add https://github.com/The-Rabak/naysmith --skill deploy-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate documentation readiness and automate preparation tasks to ensure GitHub Pages deployments succeed without surprises.

Core Features & Use Cases

  • Validates component counts in the docs repo (agents, commands, skills) and verifies JSON config files are well-formed.
  • Checks that required HTML pages exist for deployment and detects missing assets or pages early.
  • Provides deployment guidance and an example GitHub Actions workflow to publish to GitHub Pages.

Quick Start

Run the deploy-docs workflow to validate and publish docs to GitHub Pages.

Frequently Asked Questions about deploy-docs

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

FAQPage Schema
How do I validate documentation for GitHub Pages deployment?▼

To validate documentation for GitHub Pages deployment, you can run an automated workflow that checks component counts, verifies JSON config files are well-formed, and ensures required HTML pages exist before publishing.

What is the best way to check if a monorepo is ready for GitHub Pages?▼

Checking monorepo readiness for GitHub Pages involves validating component counts in plugins or compound-engineering docs, confirming JSON validity, and detecting missing HTML pages or uncommitted changes early to prevent deployment failures.

How do I automate publishing HTML documentation to GitHub Pages?▼

Automating HTML documentation publishing to GitHub Pages is done by using a provided GitHub Actions workflow that validates your JSON configs and component counts, then deploys the prepared pages automatically.

Does this documentation validation workflow require any external dependencies?▼

No external dependencies are required to run the documentation validation workflow, as it operates directly on your monorepo structure to validate JSON files and HTML page availability.

Why does my GitHub Pages deployment fail when JSON configs are invalid?▼

GitHub Pages deployment fails when JSON configs are invalid because the documentation preparation process cannot verify component counts or load the necessary configuration, causing the validation checks to halt before publishing.