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

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

health_check()

health_check()

Compare Environments

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

get_api_resources()

kubectl_get(resource_type="crds", name="certificates.cert-manager.io")

kubectl_get(resource_type="crds")

Resource Analysis

get_nodes_summary()

kubeconfig_view()

list_contexts()

Diagnostic Workflows

Cluster Overview

health_check()
get_nodes_summary()
kubectl_get(resource_type="events", namespace="")
kubectl_get(resource_type="crds")

Pre-deployment Check

kubectl_top(namespace="production")
get_nodes_summary()
compare_namespaces(namespace1="staging", namespace2="prod", resource_type="deployment")

Post-incident Analysis

kubectl_get(resource_type="events", namespace)
kubectl_logs(name, namespace, previous=True)
kubectl_top(namespace)
kubectl_describe(name)

Related Skills

• k8s-troubleshoot - Debug issues
• k8s-cost - Cost analysis
• k8s-incident - Incident response