site-reliability-engineer

Validate Docusaurus site builds with pre-commit and pre-build checks.

181|30|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/curiositech/some_claude_skills --skill site-reliability-engineer-curiositech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-reliability-engineer
Source: https://github.com/curiositech/some_claude_skills/tree/main/.claude/skills/site-reliability-engineer
Command: npx skills add https://github.com/curiositech/some_claude_skills --skill site-reliability-engineer-curiositech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents common build failures and deployment issues for Docusaurus-powered websites by performing automated validation checks before and after builds.

Core Features & Use Cases

  • Pre-commit Validation: Catches Liquid syntax errors, unescaped angle brackets, and incorrect component props before code is committed.
  • Pre-build Checks: Validates links and ensures critical assets like hero images and ZIP files are present.
  • Post-build Health Reports: Generates a summary of build success, broken links, and skill asset coverage.
  • Use Case: Before deploying a new skill to the Claude Skills showcase, this Skill ensures all MDX files are correctly formatted, all links are valid, and the site builds without errors, preventing broken pages and improving user experience.

Quick Start

Run npm run validate:all in the website directory to perform all pre-build checks.

Frequently Asked Questions about site-reliability-engineer

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

FAQPage Schema
How do I validate Docusaurus MDX syntax before deployment?

You can validate Docusaurus MDX syntax by running automated pre-commit checks that detect Liquid syntax errors, unescaped angle brackets, and incorrect SkillHeader component props before code is committed.

What's the best way to prevent Docusaurus build failures from broken links and missing assets?

The best way to prevent Docusaurus build failures is to run pre-build validation checks that verify link integrity and ensure critical assets like hero images and ZIP files are present before the build executes.

Can I integrate Docusaurus site reliability checks into my GitHub Actions CI/CD pipeline?

Yes, you can integrate Docusaurus site reliability checks into GitHub Actions CI/CD pipelines by running validation scripts that perform pre-commit and pre-build checks during your automated deployment workflows.

Why does my Docusaurus build fail when deploying new MDX pages to a showcase?

Your Docusaurus build may fail when deploying new MDX pages due to unescaped angle brackets, invalid Liquid syntax, or missing critical assets that pre-commit and pre-build validation checks are designed to catch.

Do I need npm to run Docusaurus site health and deployment safety checks?

Yes, you need npm to run Docusaurus site health checks by executing `npm run validate:all` in the website directory, which performs comprehensive pre-build validation for MDX syntax, links, and assets.