About

Imported from curiositech/some_claude_skills (.claude/skills/site-reliability-engineer/SKILL.md). Install upstream with npx skills add curiositech/some_claude_skills --skill site-reliability-engineer. Copyright stays with the author.

Site Reliability Engineer

Name: site-reliability-engineer
Author: curiositech

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)

npm run install-hooks

Manual Validation

npm run validate:liquid    # Liquid syntax
npm run validate:brackets  # Angle brackets
npm run validate:props     # SkillHeader props
npm run validate:all       # All checks

Clear Cache (When Stuck)

rm -rf .docusaurus build node_modules/.cache
npm run build

Pre-Commit Validation

The pre-commit hook automatically:

Liquid syntax - Scans for double-brace templates outside code blocks
Angle brackets - Finds <digit patterns
SkillHeader props - Validates component usage
Required files - Checks hero images, ZIPs exist

Speed: Under 5 seconds for typical commits

Expert vs Novice Approach

Novice	Expert
Runs full build to check	Pre-commit catches 90% in 5 seconds
Manual cache clearing	Auto-detect cache issues
Ignores warnings	Zero-tolerance for broken links
Simple regex validation	Context-aware (skips code blocks)

Anti-Patterns

Anti-Pattern: Full Build for Validation

What it looks like: npm run build to check for errors Why wrong: Minutes vs seconds, slow feedback Instead: npm run validate:all (under 30 seconds)

Anti-Pattern: Ignoring Build Warnings

What it looks like: "Build succeeded, ship it!" (ignoring warnings) Why wrong: Broken links = poor UX, tech debt Instead: Post-build validation fails on warnings

Anti-Pattern: Naive Regex Validation

What it looks like: /\{\{.*?\}\}/ (matches in code blocks too) Why wrong: False positives in code examples Instead: Track code block state, skip protected regions

Scripts (in `scripts/` folder)

Script	Purpose
`validate-liquid.js`	Detect unescaped Liquid syntax
`validate-brackets.js`	Detect unescaped angle brackets
`validate-skill-props.js`	Validate SkillHeader component

Troubleshooting Quick Reference

Issue	Diagnosis	Fix
Hook not running	`ls -la .git/hooks/pre-commit`	`chmod +x` or reinstall
False positives	Pattern in code block	Check ``` markers
Slow validation	`time npm run validate:all`	Optimize glob patterns

Success Metrics

After installing hooks:

Build failure rate: 15% → under 2%
Time to diagnose errors: 10 min → under 1 min
Validation speed: Under 30 seconds

Reference Files

references/validation-logic.md - Context-aware detection patterns
references/ci-cd-integration.md - GitHub Actions, health reports
scripts/ - Working validation scripts

Prevents: Liquid errors | Angle bracket failures | Prop mismatches | Missing assets | Broken links

Use with: skill-documentarian (sync) | docusaurus-expert (advanced config)

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/curiositech-some-claude-skills-site-reliability-engineer/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

curiositech-some-claude-skills-site-reliability-engineer.ocm.jsonjson

{
  "ocm": "1",
  "id": "curiositech-some-claude-skills-site-reliability-engineer",
  "kind": "skill",
  "name": "site-reliability-engineer",
  "description": "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.",
  "publisher": "curiositech",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "docusaurus",
      "build-health",
      "mdx",
      "validation",
      "deployment",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "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."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/curiositech/some_claude_skills",
      "path": ".claude/skills/site-reliability-engineer/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/curiositech/some_claude_skills/blob/HEAD/.claude/skills/site-reliability-engineer/SKILL.md",
      "key": "curiositech/some_claude_skills/.claude/skills/site-reliability-engineer/SKILL.md"
    },
    "allowed_tools": [
      "Read,Write,Edit,Bash,Grep,Glob"
    ]
  },
  "instructions": "# Site Reliability Engineer\n\nExpert 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.\n\n## When to Use\n\n**Use for:**\n- Pre-commit validation of markdown/MDX files\n- Catching Liquid template syntax errors\n- Validating SkillHeader component props\n- Checking for missing hero images/ZIP files\n- Pre-build link validation\n- Post-build health reports\n- Diagnosing Docusaurus build failures\n\n**Do NOT use for:**\n- General DevOps (use deployment-engineer)\n- Kube",
  "cost": {
    "context_tokens": 1045
  }
}

Fetch it by URL: GET /api/v1/registry/curiositech-some-claude-skills-site-reliability-engineer/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.