k8s-diagnostics — скилл для Claude Code: диагностика кластера
Скилл k8s-diagnostics учит агента снимать метрики подов и нод, проверять здоровье кластера и сравнивать окружения через инструменты kubectl-mcp-server.
MIT-0 1 установок ★ 976 обновлён 2026-10-22
npx skills add rohitg00/kubectl-mcp-server --skill k8s-diagnostics -a claude-codeЧто делает k8s-diagnostics
Скилл даёт агенту диагностический набор kubectl-mcp-server: health_check, kubectl_top, get_nodes_summary, compare_namespaces, kubectl_get, get_api_resources, kubeconfig_view, list_contexts, а для разбора аварий ещё kubectl_logs и kubectl_describe. Подхватывается на словах «метрики», «health check», «сравни», «ёмкость».
Сценариев три: обзор кластера, проверка перед деплоем и разбор после падения. Перед выкаткой скилл советует снять kubectl_top по namespace, сводку по нодам и сравнить staging с production по деплойментам. После инцидента берёт события, логи предыдущего контейнера и kubectl_describe.
MCP-сервер должен быть запущен с тулсетами diagnostics и multicluster: --toolsets default,diagnostics,multicluster или переменная MCP_TOOLSETS=default,diagnostics,multicluster. Без metrics-server в кластере kubectl_top ничего не покажет, поэтому скилл первым делом велит проверить, что он есть.
Какие задачи решает
- снять метрики CPU и памяти по подам и нодам
- проверить здоровье кластера перед выкаткой
- сравнить деплойменты в
stagingиproduction - разобрать события и логи предыдущего контейнера после падения пода
- посмотреть список CRD и доступных API-ресурсов
Примеры запросов агенту
- Проверь здоровье кластера и покажи топ подов по памяти в
production. - Сравни деплойменты в
stagingиproductionперед релизом. - Под упал: вытащи события в namespace, логи предыдущего контейнера и
kubectl_describe.
Как установить k8s-diagnostics
1Через Skills CLI (Vercel)
npx skills add rohitg00/kubectl-mcp-server --skill k8s-diagnostics -a claude-code2Вручную: положить файлы
~/.claude/skills/k8s-diagnostics/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/k8s-diagnostics/
1Через Skills CLI (Vercel)
npx skills add rohitg00/kubectl-mcp-server --skill k8s-diagnostics -a codex2Вручную: положить файлы
.agents/skills/k8s-diagnostics/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rohitg00/kubectl-mcp-server --skill k8s-diagnostics -a cursor2Вручную: положить файлы
.cursor/skills/k8s-diagnostics/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rohitg00/kubectl-mcp-server kubernetes-skills/claude/k8s-diagnostics2Вручную: положить файлы
.github/skills/k8s-diagnostics/SKILL.md1Через Skills CLI (Vercel)
npx skills add rohitg00/kubectl-mcp-server --skill k8s-diagnostics -a gemini-cli2Командой платформы
gemini skills install https://github.com/rohitg00/kubectl-mcp-server --path kubernetes-skills/claude/k8s-diagnosticsВручную: положить файлы
.devin/skills/k8s-diagnostics/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add rohitg00/kubectl-mcp-server --skill k8s-diagnostics -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о k8s-diagnostics
Как установить k8s-diagnostics в Claude Code?
Выполните npx skills add rohitg00/kubectl-mcp-server --skill k8s-diagnostics -a claude-code, скилл окажется в ~/.claude/skills/k8s-diagnostics/SKILL.md.
Что делает k8s-diagnostics?
Описывает агенту, какими инструментами kubectl-mcp-server снимать метрики, проверять здоровье кластера, сравнивать неймспейсы и собирать диагностику после инцидента.
Что нужно, чтобы скилл заработал?
Запущенный kubectl-mcp-server с тулсетами diagnostics и multicluster, а для метрик ещё metrics-server в кластере.
Исходный текст
SKILL.md · MIT-0
---
name: k8s-diagnostics
description: Kubernetes diagnostics for metrics, health checks, resource comparisons, and cluster analysis. Use when analyzing cluster health, comparing environments, or gathering diagnostic data.
license: MIT-0
metadata:
author: rohitg00
version: "2.0.0"
tools: 10
category: observability
---
# Kubernetes Diagnostics
Analyze cluster health and compare resources using kubectl-mcp-server's diagnostic tools.
> Requires the `diagnostics`, `multicluster` toolsets: start kubectl-mcp-server with `--toolsets default,diagnostics,multicluster` (or `MCP_TOOLSETS=default,diagnostics,multicluster`).
## When to Apply
Use this skill when:
- User mentions: "metrics", "health check", "compare", "analysis", "capacity"
- Operations: cluster health assessment, environment comparison, resource analysis
- Keywords: "how much", "usage", "difference between", "capacity planning"
## Priority Rules
| Priority | Rule | Impact | Tools |
|----------|------|--------|-------|
| 1 | Check metrics-server before using metrics | CRITICAL | `kubectl_top` |
| 2 | Run health check before deployments | HIGH | `health_check` |
| 3 | Compare staging vs prod before release | MEDIUM | `compare_namespaces` |
| 4 | Document baseline metrics | LOW | `get_nodes_summary` |
## Quick Reference
| Task | Tool | Example |
|------|------|---------|
| Cluster health | `health_check` | `health_check()` |
| Pod metrics | `kubectl_top` | `kubectl_top(namespace)` |
| Node summary | `get_nodes_summary` | `get_nodes_summary()` |
| Compare envs | `compare_namespaces` | `compare_namespaces(ns1, ns2, type)` |
| List CRDs | `kubectl_get` | `kubectl_get(resource_type="crds")` |
## Resource Metrics
```python
kubectl_top(namespace="default")
kubectl_top(resource="nodes")
kubectl_top(resource="pods", namespace="default", sort_by="cpu")
kubectl_top(resource="pods", namespace="default", sort_by="memory")
```
## Cluster Health Check
```python
health_check()
health_check()
```
## Compare Environments
```python
compare_namespaces(
namespace1="staging",
namespace2="production",
resource_type="deployment"
)
kubectl_get(resource_type="deployments", namespace="default", context="staging-cluster")
kubectl_get(resource_type="deployments", namespace="default", context="prod-cluster")
```
## API Discovery
```python
get_api_resources()
kubectl_get(resource_type="crds", name="certificates.cert-manager.io")
kubectl_get(resource_type="crds")
```
## Resource Analysis
```python
get_nodes_summary()
kubeconfig_view()
list_contexts()
```
## Diagnostic Workflows
### Cluster Overview
```python
health_check()
get_nodes_summary()
kubectl_get(resource_type="events", namespace="")
kubectl_get(resource_type="crds")
```
### Pre-deployment Check
```python
kubectl_top(namespace="production")
get_nodes_summary()
compare_namespaces(namespace1="staging", namespace2="prod", resource_type="deployment")
```
### Post-incident Analysis
```python
kubectl_get(resource_type="events", namespace)
kubectl_logs(name, namespace, previous=True)
kubectl_top(namespace)
kubectl_describe(name)
```
## Related Skills
- [k8s-troubleshoot](../k8s-troubleshoot/SKILL.md) - Debug issues
- [k8s-cost](../k8s-cost/SKILL.md) - Cost analysis
- [k8s-incident](../k8s-incident/SKILL.md) - Incident response
© rohitg00 · MIT-0 · rohitg00/kubectl-mcp-server