site-reliability-engineer

SKILL.md

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.

| 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 |

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 health reports. Activate on 'build errors', 'commit hooks', 'deployment safety', 'site health', 'MDX validation'. NOT for general DevOps (use deployment-engineer), Kubernetes/cloud infrastructure (use kubernetes-architect), runtime monitoring (use observability-engineer), or non-Docusaurus projects. Source: erichowens/some_claude_skills.

View raw