Kubernetes Skill

Скилл KubeShark: агент сначала ищет режим отказа, потом пишет манифесты, Helm и Kustomize по официальным практикам и возвращает план проверки и отката

  • 465 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Минимальный доступ

Почему такой уровень

  • Скилл состоит из инструкций и справочных файлов и сам ничего не запускает и никуда не обращается
  • Команды проверки, которые он предлагает, агент выполняет по вашему подтверждению в вашем окружении
Все причины и проверки

lukasniessen/kubernetes-skill

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/kubernetes-skill

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Скилл состоит из инструкций и справочных файлов и сам ничего не запускает и никуда не обращается
  • Команды проверки, которые он предлагает, агент выполняет по вашему подтверждению в вашем окружении

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Kubernetes Skill, у автора названный KubeShark, добавляет Claude Code и Codex процедуру работы с Kubernetes. Перед тем как писать манифест, агент фиксирует контекст: версию кластера и дистрибутив, пространство имен, критичность среды, тип рабочей нагрузки, способ развертывания, политики безопасности и облачного провайдера. Незнакомые параметры он обязан объявить допущениями. Потом агент выбирает один или несколько режимов отказа из шести: небезопасные настройки по умолчанию, нехватка ресурсов, сетевая открытость, избыточные права, хрупкие выкатки и дрейф версий API. Под выбранный режим он загружает только нужные справочные файлы. Для EKS, GKE, AKS, OpenShift, Argo CD и Flux, а также для Prometheus Operator и OpenTelemetry есть условные справочники, они подключаются при появлении признаков платформы. Скилл заканчивает работу контрактом ответа: допущения и нижняя граница версии кластера, выбранные режимы отказа, компромиссы, план проверки и заметки по откату. Проверка включает kubectl apply --dry-run=server или kubectl diff, kubeconform, согласованность меток, селекторов и портов, проверку профиля Pod Security Standards и аудит Kyverno или OPA Gatekeeper. Применять изменения в боевой кластер без просмотренного diff скилл не рекомендует.

Для кого. Для DevOps-инженеров и разработчиков, которые просят Claude Code или Codex писать и проверять манифесты, чарты Helm и оверлеи Kustomize для реальных кластеров.

Подходит, если

  • Нужен Deployment с Ingress и автомасштабированием, и в нем должны быть контексты безопасности, лимиты ресурсов и корректные пробы
  • Нужно проверить готовый deployment.yaml на лишние права, отсутствие NetworkPolicy и RBAC с подстановочными знаками
  • Манифесты с apiVersion времен до 1.22 надо перевести на актуальные API
  • Нужен чарт Helm для StatefulSet PostgreSQL с заданиями резервного копирования CronJob
  • Кластер работает в EKS, GKE, AKS или OpenShift, и ответ должен учесть особенности платформы

Не подходит, если

  • Нужно управлять живым кластером из чата: скилл только готовит и проверяет файлы, а команд к кластеру сам не выполняет
  • Нужен общий инфраструктурный набор для Terraform, Docker и CI: для этого в каталоге есть отдельные DevOps-наборы
  • Задача не связана с Kubernetes: описание скилла срабатывает на манифесты, Helm, Kustomize и политики кластера

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

/kubernetes-skill Проверь мой deployment.yaml на проблемы безопасности, добавь RBAC, NetworkPolicy и лимиты ресурсов

Ограничения

  • Скилл состоит из инструкций и справочных файлов. Он не подключается к кластеру и не запускает kubectl сам: проверки предлагает как шаги для вас или агента.
  • Качество ответа зависит от того, сообщите ли вы версию кластера и платформу. Иначе агент записывает допущения.
  • Основа справочников: документация Kubernetes, руководство NSA и CISA, OWASP Kubernetes Top 10, Pod Security Standards и CIS Kubernetes Benchmark. При конфликте приоритет у официальной документации Kubernetes.
  • Для Codex нет глобальных скиллов, поэтому скилл подключают в каждый проект через AGENTS.md.

Как отключить. Удалите папку ~/.claude/skills/kubernetes-skill или выполните /plugin uninstall kubernetes-skill, если ставили через маркетплейс. Для Codex уберите абзац про .kubernetes-skill из AGENTS.md и удалите клонированную папку.

Частые вопросы

Как поставить Kubernetes Skill в Claude Code?

Выполните npx skills add https://github.com/lukasniessen/kubernetes-skill --skill kubernetes-skill или клонируйте репозиторий в ~/.claude/skills/kubernetes-skill: Claude Code находит скиллы в этой папке без перезапуска. Есть и маркетплейс: /plugin marketplace add LukasNiessen/kubernetes-skill, затем /plugin install kubernetes-skill.

Как подключить KubeShark к Codex?

Клонируйте репозиторий в корень проекта командой git clone https://github.com/LukasNiessen/kubernetes-skill.git .kubernetes-skill и добавьте в AGENTS.md раздел Kubernetes со ссылкой на .kubernetes-skill/SKILL.md и справочники из references.

Чем скилл отличается от Kubernetes MCP Server?

MCP-сервер дает агенту работать с живым кластером. Скилл ничего не запускает в кластере: он задает порядок рассуждения и справочники для написания и проверки манифестов, чартов и политик.

Какие платформы учитывает скилл?

Условные справочники есть для EKS, GKE, AKS и OpenShift, для контроллеров GitOps Argo CD и Flux и для стеков наблюдаемости: Prometheus Operator, OpenTelemetry, Loki и Grafana. Они подгружаются, когда в запросе есть признаки платформы.

Почему скилл не грузит всю документацию сразу?

SKILL.md короткий и содержит только процедуру. Справочные файлы подключаются по выбранному режиму отказа, чтобы не тратить токены на лишние страницы.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

31 скилл для DevOps в Claude Code и Codex: генераторы конфигов, валидаторы и отладчик Kubernetes для Terraform, Helm, CI и Docker

СкиллРасширенный доступ326Звезды репозитория

Большая база скиллов по DevOps, безопасности, инфраструктуре и комплаенсу для AI-агентов

СкиллМинимальный доступ1,2 тыс.Звезды репозитория
Официальный

Официальный набор скиллов Grafana: PromQL, Loki, Tempo, Alloy, k6, дашборды и алертинг для Claude Code, Cursor и Codex

СкиллРасширенный доступ290Звезды репозитория

Docker Skills

docker-skills

Официальный

Официальные скиллы Docker для агентов: Dockerfile и сборка, Compose, Sandboxes, Docker Agent и скилл с подтверждением необратимых действий

СкиллМинимальный доступ591Звезды репозитория
Выбор редакции

Официальные скиллы HashiCorp для Terraform и Packer: стиль HCL, модули, тесты, импорт, Stacks, разработка провайдеров и сборка образов

СкиллМинимальный доступ903Звезды репозитория
Официальный

MCP-сервер и скиллы поверх сетевой обсервабилити Kubernetes: агент расследует инциденты и ищет трафик через eBPF-индекс кластера

MCP-серверРасширенный доступ12,1 тыс.Звезды репозитория

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

ЗаписьОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
Kubernetes Skill (эта запись)нет465
Kubernetes MCP Serverнетне нужна2 179MCP-сервер, который работает с ресурсами, подами и логами живого кластера через его API
cc-devops-skillsнет32631 скилл для Terraform, Helm, CI и Docker, а не одна процедура для Kubernetes

Коротко о README

README начинается с обещания убрать галлюцинации ИИ в Kubernetes: пропущенные контексты безопасности, устаревшие API, права с подстановочными знаками, отсутствие лимитов и пробы, ведущие к каскадным сбоям. Дальше идут четыре способа установки, сравнение с работой без скилла, объяснение подхода от режимов отказа, стратегия экономии токенов и состав справочных файлов. Лицензия MIT.

Бейдж для README

Исходный SKILL.md

---
name: kubernetes-skill
description: "Prevent Kubernetes hallucinations by diagnosing and fixing failure modes: insecure workload defaults, resource starvation, network exposure, privilege sprawl, fragile rollouts, and API drift. Use when generating, reviewing, refactoring, or migrating manifests, Helm charts, Kustomize overlays, cluster policies, and platform-specific Kubernetes work for EKS, GKE, AKS, OpenShift, GitOps controllers, or observability stacks."
---

# KubeShark: Failure-Mode Workflow for Kubernetes

Run this workflow top to bottom.

## 1) Capture execution context

Record before writing manifests:
- cluster version (e.g. 1.30, 1.31) and distribution (EKS, GKE, AKS, k3s, vanilla)
- target namespace and environment criticality (dev/staging/prod)
- workload type (Deployment, StatefulSet, Job, CronJob, DaemonSet)
- deployment method (raw YAML, Helm, Kustomize, operator-managed)
- policy enforcement (Pod Security Admission level, Kyverno, OPA/Gatekeeper)
- cloud provider and CNI (affects networking, storage classes, load balancers)
- platform controllers/add-ons (GitOps, observability, ingress, service mesh, autoscaling)

If unknown, state assumptions explicitly.

## 2) Diagnose likely failure mode(s)

Select one or more based on user intent and risk:
- insecure workload defaults: missing security contexts, PSS violations, host access
- resource starvation: missing requests/limits, no PDB, scheduling chaos
- network exposure: flat networking, missing policies, wrong Service types, DNS issues
- privilege sprawl: overly permissive RBAC, leaked secrets, excess ServiceAccount rights
- fragile rollouts: misconfigured probes, mutable tags, unsafe update strategies
- API drift: wrong apiVersion, deprecated APIs, schema violations, tool-specific errors

## 3) Load only the relevant reference file(s)

Primary failure-mode references:
- `references/insecure-workload-defaults.md`
- `references/resource-starvation.md`
- `references/network-exposure.md`
- `references/privilege-sprawl.md`
- `references/fragile-rollouts.md`
- `references/api-drift.md`

Supplemental references (only when needed):
- `references/deployment-patterns.md`
- `references/stateful-patterns.md`
- `references/job-patterns.md`
- `references/daemonset-operator-patterns.md`
- `references/security-hardening.md`
- `references/observability.md`
- `references/multi-tenancy.md`
- `references/storage-and-state.md`
- `references/helm-patterns.md`
- `references/kustomize-patterns.md`
- `references/validation-and-policy.md`
- `references/examples-good.md`

Сообщить о проблеме

Foxx AIKubernetes Skill
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.