К основному содержанию
скилл CX Codex

site-reliability-engineer — скилл для Claude Code: проверка сайта

Скилл site-reliability-engineer проверяет здоровье сборки Docusaurus: ищет ошибки в MDX, проверяет ссылки и помогает подготовить безопасный деплой.

MIT 196 установок ★ 274 обновлён 2026-10-30

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add curiositech/some_claude_skills --skill site-reliability-engineer -a claude-code
Открыть на GitHub

Что делает site-reliability-engineer

Перед коммитом скилл проверяет MDX на ошибки Liquid-синтаксиса, незакрытые угловые скобки и неверные пропсы SkillHeader. Также он проверяет наличие нужных изображений и ZIP-файлов. Хук можно установить командой npm run install-hooks.

Для ручной проверки доступны команды npm run validate:liquid, npm run validate:brackets, npm run validate:props и npm run validate:all. Перед сборкой скилл помогает проверить ссылки, а после неё — сформировать отчёт о здоровье сайта. Скрипты проверок лежат в scripts/; обычный npm run build не заменяет их, когда нужно быстро проверить изменения до коммита.

Скилл рассчитан на Docusaurus и сайт-витрину Claude Skills. Для Kubernetes, облачной инфраструктуры и мониторинга во время работы приложения в README рекомендованы другие скиллы.

Какие задачи решает

  • найти Liquid-шаблоны, которые ломают MDX
  • проверить пропсы компонента SkillHeader
  • обнаружить отсутствующие изображения и ZIP-файлы
  • проверить ссылки перед сборкой
  • разобраться с ошибками сборки Docusaurus

Примеры запросов агенту

  • Проверь MDX перед коммитом и найди ошибки Liquid-синтаксиса.
  • Проверь ссылки и состояние сайта после сборки Docusaurus.
  • Запусти все проверки с помощью npm run validate:all.

Как установить site-reliability-engineer

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill site-reliability-engineer -a claude-code

2Вручную: положить файлы

~/.claude/skills/site-reliability-engineer/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/site-reliability-engineer/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о site-reliability-engineer

Как установить site-reliability-engineer в Claude Code?

Выполните npx skills add curiositech/some_claude_skills --skill site-reliability-engineer -a claude-code. Файл скилла будет доступен по пути ~/.claude/skills/site-reliability-engineer/SKILL.md.

Что делает site-reliability-engineer?

Проверяет MDX и ссылки, валидирует пропсы SkillHeader и наличие нужных файлов. Также помогает диагностировать сбои сборки Docusaurus и проверять сайт после неё.

Какие проверки можно запустить вручную?

Для отдельных проверок используйте npm run validate:liquid, npm run validate:brackets или npm run validate:props. Команда npm run validate:all запускает полный набор.

Исходный текст

SKILL.md · MIT
---
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.
allowed-tools: Read,Write,Edit,Bash,Grep,Glob
metadata:
  category: DevOps & Site Reliability
  pairs-with:
  - skill: devops-automator
    reason: CI/CD for site deployments
  - skill: skill-documentarian
    reason: Maintain skill documentation quality
  tags:
  - docusaurus
  - build-health
  - mdx
  - validation
  - deployment
---

# 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)
```bash
npm run install-hooks
```

### Manual Validation
```bash
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)
```bash
rm -rf .docusaurus build node_modules/.cache
npm run build
```

## 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. **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)

© curiositech · MIT · curiositech/some_claude_skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
deployment-engineer zhaono1 Скилл deployment-engineer настраивает пайплайны CI/CD, готовит конфигурации релизов и стратегии отката. Защищает прод: агент не запустит деплой без явного подтверждения. CX Codex +1 685установок cicd-automation-deployment-engineer Seth Hobson Субагент cicd-automation-deployment-engineer помогает проектировать CI/CD-пайплайны, GitOps-развёртывание и автоматические откаты. Подключайте его, когда нужно настроить доставку приложения или проверить безопасность пайплайна. CX Codex ★ 42 780звёзд репо gke-reliability официальный google Скилл gke-reliability для Claude Code, Gemini CLI и Codex, который настраивает надёжность рабочих нагрузок GKE: PodDisruptionBudget, пробы здоровья и topology spread constraints. CX Codex +1 6 500установок docusaurus-expert davila7 Субагент docusaurus-expert для Claude Code настраивает сайты Docusaurus v2 и v3: структуру, боковое меню и MDX-статьи, а также исправляет сбои сборки. CX Codex 1 143установок reliability-engineer Son Nguyen Субагент reliability-engineer проверяет надёжность сессий Claude Code через Agent Monitor: считает SLO, ищет сбои инструментов и моделей, а также проблемы с хуками. CX Codex ★ 1 198звёзд репо chaos-engineer https://github.com/Jeffallan Скилл chaos-engineer для Claude Code: планирует chaos-эксперименты, внедряет инъекцию отказов и проводит game day. Проверяет, как распределённая система переживает падение пода или задержку сети. CX Codex +1 4 400установок

Из того же набора180

Весь набор →
sober-addict-protector Скилл sober-addict-protector помогает вести ежедневные проверки трезвости, замечать триггеры и готовить план защиты от срыва. CX Codex +1 199установок product-appeal-analyzer Скилл product-appeal-analyzer оценивает, захочет ли целевая аудитория выбрать продукт: разбирает позиционирование, доверие и эмоциональный отклик. Используйте его для ревью лендинга или сообщений о продукте. CX Codex +1 199установок background-job-orchestrator Скилл background-job-orchestrator помогает настроить фоновые очереди на BullMQ или Celery. Переносит тяжёлые операции из обработчиков API, добавляет повторные попытки и защищает сервис от перегрузок. CX Codex +1 198установок skill-logger Скилл skill-logger для Claude Code, Codex, Cursor и других платформ: фиксирует каждый запуск скилла, считает метрики качества и собирает сигналы для улучшений. CX Codex +1 197установок skill-documentarian Скилл skill-documentarian синхронизирует навыки с документацией сайта, следит за метаданными, тегами и бейджами. Нужен при добавлении или проверке скиллов. CX Codex +1 196установок vr-avatar-engineer Скилл vr-avatar-engineer для Claude Code проектирует VR-аватары. Охватывает отслеживание мимики, сетевую синхронизацию и рендеринг кожи для Vision Pro, Quest и PC VR. CX Codex +1 195установок real-time-collaboration-engine Скилл real-time-collaboration-engine для Claude Code помогает проектировать совместное редактирование в реальном времени через WebSockets, OT или CRDT. Описывает синхронизацию редакторов, досок и курсоров. CX Codex +1 195установок competitive-cartographer Скилл competitive-cartographer строит карты конкурентов и находит свободные ниши для продуктов, услуг или резюме. Помогает отстроиться от других, когда вокруг слишком много похожих предложений. CX Codex +1 194установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой