site-reliability-engineer — скилл для Claude Code: проверка сайта
Скилл site-reliability-engineer проверяет здоровье сборки Docusaurus: ищет ошибки в MDX, проверяет ссылки и помогает подготовить безопасный деплой.
MIT 196 установок ★ 274 обновлён 2026-10-30
npx skills add curiositech/some_claude_skills --skill site-reliability-engineer -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/site-reliability-engineer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/site-reliability-engineer/
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill site-reliability-engineer -a codex2Вручную: положить файлы
.agents/skills/site-reliability-engineer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill site-reliability-engineer -a cursor2Вручную: положить файлы
.cursor/skills/site-reliability-engineer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install curiositech/some_claude_skills .claude/skills/site-reliability-engineer2Вручную: положить файлы
.github/skills/site-reliability-engineer/SKILL.md1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill site-reliability-engineer -a gemini-cli2Командой платформы
gemini skills install https://github.com/curiositech/some_claude_skills --path .claude/skills/site-reliability-engineerВручную: положить файлы
.devin/skills/site-reliability-engineer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill site-reliability-engineer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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