Agent skill

k8s-diagnostics

Kubernetes diagnostics for metrics, health checks, resource comparisons, and cluster analysis. Use when analyzing cluster health, comparing environments, or gathering diagnostic data.

Stars 865
Forks 168

Install this agent skill to your Project

npx add-skill https://github.com/rohitg00/kubectl-mcp-server/tree/main/kubernetes-skills/claude/k8s-diagnostics

Metadata

Additional technical details for this skill

tools
10
author
rohitg00
version
1.0.0
category
observability

SKILL.md

Kubernetes Diagnostics

Analyze cluster health and compare resources using kubectl-mcp-server's diagnostic tools.

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 get_resource_metrics
2 Run health check before deployments HIGH cluster_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 cluster_health_check cluster_health_check()
Pod metrics get_resource_metrics get_resource_metrics(namespace)
Node summary get_nodes_summary get_nodes_summary()
Compare envs compare_namespaces compare_namespaces(ns1, ns2, type)
List CRDs list_crds list_crds()

Resource Metrics

python
get_resource_metrics(namespace="default")

get_node_metrics()

get_top_pods(namespace="default", sort_by="cpu")

get_top_pods(namespace="default", sort_by="memory")

Cluster Health Check

python
cluster_health_check()

get_cluster_info()

Compare Environments

python
compare_namespaces(
    namespace1="staging",
    namespace2="production",
    resource_type="deployment"
)

compare_namespaces(
    namespace1="default",
    namespace2="default",
    resource_type="deployment",
    context1="staging-cluster",
    context2="prod-cluster"
)

API Discovery

python
get_api_versions()

check_crd_exists(crd_name="certificates.cert-manager.io")

list_crds()

Resource Analysis

python
get_nodes_summary()

kubeconfig_view()

list_contexts_tool()

Diagnostic Workflows

Cluster Overview

python
cluster_health_check()
get_nodes_summary()
get_events(namespace="")
list_crds()

Pre-deployment Check

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

Post-incident Analysis

python
get_events(namespace)
get_pod_logs(name, namespace, previous=True)
get_resource_metrics(namespace)
describe_node(name)

Related Skills

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

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results