# k8s-yaml-validator

Скилл прогоняет манифесты Kubernetes через линтер, схемы и dry-run и выдаёт отчёт с ошибками по строкам. Полезен перед kubectl apply.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 672 установки · ★ 327
- Автор: akin-ozer
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/akin-ozer/cc-devops-skills/tree/HEAD/devops-skills-plugin/skills/k8s-yaml-validator/SKILL.md
- Обновлён: 2026-07-26
- HTML: https://affpapa.org/nevibecode/skills/k8s-yaml-validator

## Что делает

Скилл запускает проверку в несколько этапов. Сначала считает документы в файле скриптом `count_yaml_documents.py`, потом проверяет наличие инструментов через `setup_tools.sh`, затем гоняет `yamllint` с конфигом из `assets/.yamllint` и валидирует схемы через kubeconform. Для CRD он ищет документацию: сначала через Context7 MCP, если тот не отвечает — веб-поиском.

Главное ограничение: это только отчёт. Скилл не правит файлы, не вызывает Edit и не спрашивает разрешения что-то исправить. Предлагаемые правки он показывает блоками «до/после», а решение остаётся за вами. Так что если ждёте автопочинки манифеста — её тут нет.

Для работы нужны `yamllint` и `kubeconform`, `kubectl` желателен для dry-run. Если чего-то не хватает, скилл покажет подсказку по установке и продолжит с тем, что есть, отметив пропущенные этапы в отчёте. `python3` нужен для подсчёта документов и разбора CRD; без него остаётся awk-фолбэк с пометкой «estimated».

## Требования
- Работает с: Kubernetes

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akin-ozer/cc-devops-skills --skill k8s-yaml-validator -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/k8s-yaml-validator/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/k8s-yaml-validator/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akin-ozer/cc-devops-skills --skill k8s-yaml-validator -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/k8s-yaml-validator/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akin-ozer/cc-devops-skills --skill k8s-yaml-validator -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/k8s-yaml-validator/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akin-ozer/cc-devops-skills k8s-yaml-validator
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/k8s-yaml-validator/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akin-ozer/cc-devops-skills --skill k8s-yaml-validator -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/akin-ozer/cc-devops-skills --path devops-skills-plugin/skills/k8s-yaml-validator
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/k8s-yaml-validator/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add akin-ozer/cc-devops-skills --skill k8s-yaml-validator -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/akin-ozer/cc-devops-skills/tree/HEAD/devops-skills-plugin/skills/k8s-yaml-validator/SKILL.md

## Когда брать
- поймать ошибки отступов и синтаксиса в манифесте до деплоя
- проверить схему CRD, для которого нет встроенной валидации
- прогнать dry-run и увидеть ошибки admission-контроллеров
- разобрать многодокументный YAML и найти проблемные строки
- понять, какие поля обязательны в spec незнакомого CRD

## Примеры запросов агенту
- Проверь этот Kubernetes YAML перед деплоем
- Прогони линтер по манифестам и покажи, что сломано
- Проверь CRD-манифест и объясни проблемы со схемой

## Похожие
- [k8s-manifest-generator](https://affpapa.org/nevibecode/skills/k8s-manifest-generator.md) — скилл · 11166 установок
- [helm-chart-scaffolding](https://affpapa.org/nevibecode/skills/helm-chart-scaffolding.md) — скилл · 11964 установки
- [kubernetes-ops](https://affpapa.org/nevibecode/skills/kubernetes-ops.md) — скилл · 391 установка
- [helm-charts](https://affpapa.org/nevibecode/skills/helm-charts.md) — скилл · 357 установок
- [observability-k8s-investigation](https://affpapa.org/nevibecode/skills/observability-k8s-investigation.md) — скилл · 3000 установок
- [kubernetes](https://affpapa.org/nevibecode/rules/kubernetes.md) — правило · ★ 3579

Из того же набора: [akin-ozer/cc-devops-skills](https://affpapa.org/nevibecode/by/akin-ozer/cc-devops-skills.md) — 28 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md