deploy-docs

Validate documentation files before GitHub Pages deployment by checking agent and skill counts, verifying JSON structures with jq, and confirming all expected HTML pages exist in the docs directory.

Git status inspection for documentation deployment safety detects uncommitted changes in the docs directory and prompts for commits, preventing broken or incomplete pages from reaching production.

Check plugin JSON files before publishing HTML documentation by running jq validation on marketplace and plugin JSON structures to ensure they parse correctly and meet deployment requirements.

Yes, you need a clean workspace before triggering a GitHub Pages workflow; the validation inspects git status for unstaged edits in the docs folder and prompts for commits to guarantee deploy safety.

Missing HTML pages in the plugin docs directory cause validation to fail, blocking the deployment process so incomplete documentation cannot be published to GitHub Pages.

Automate documentation validation across multiple HTML pages and JSON files through repeated file existence checks and jq structural validation, summarizing workflow permissions and manual trigger steps for safe deployment.