Agent skill · software engineering · erichowens
site-reliability-engineer
Docusaurus build health validation and deployment safety for Claude Skills showcase. Pre-commit MDX validation (Liquid syntax, angle brackets, prop mismatches), pre-build link checking, post-build
Why this skill is useful
Adds specific pre-commit validation scripts and checks for Docusaurus that the AI wouldn't reliably generate on its own.
What it needs
Requires npm installed locally. About 3k tokens when loaded. Last updated 2026-07-14. 180 stars on the source repository.
What this skill does
Site Reliability Engineer Expert in Docusaurus build health, MDX validation, and deployment safety for the Claude Skills showcase website. Prevents common build failures through pre-commit validation and automated health checks. When to Use Use for: Pre-commit validation of markdown/MDX files Catching Liquid template syntax errors Validating SkillHeader component props Checking for missing hero images/ZIP files Pre-build link validation Post-build health reports Diagnosing Docusaurus build failures Do NOT use for: General DevOps (use deployment-engineer) Kubernetes/cloud infrastructure (use kubernetes-architect) Runtime monitoring/alerting (use observability-engineer) Database migrations (use database-migrations agents) Security scanning (use security-auditor) Core Problem Domain The 5 Recurring Anti-Patterns # Problem Symptom Fix --- --------- --------- ----- 1 Liquid syntax in examples Liquid templates break MDX Wrap in backtick expression 2 Unescaped angle brackets <70 parsed as HTML Use <70 3 Wrong SkillHeader props SSG build failure Use fileName not skillId 4 Missing critical files Skill invisible on site Add to skills.ts 5 Cache corruption Phantom errors Clear .docusaurus, build Quick Start Install Hooks (One-Time) Manual Validation Clear Cache (When Stuck) Pre-Commit Validation The pre-commit hook automatically: 1. Liquid syntax - Scans for double-brace templates outside code blocks 2. Angle brackets - Finds <digit patterns 3. SkillHeader props - Validates component usage 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills erichowens/site-reliability-engineer