Updated 1d ago
by k8s-servant
k8s-skills
Read-only Kubernetes troubleshooting skills for Claude Code, Codex, Gemini CLI and Copilot. Each one tested by an agent on a real kind cluster.
31 GitHub stars (31)
+31 in 9 days
| Period | New stars |
|---|---|
| Oct 28 | +2 |
| Oct 29 | +1 |
| Oct 30 | +2 |
| Oct 31 | 0 |
- 26 skills (26 skills found in its SKILL.md files)
- 6 forks (6 forks)
- 1d ago last update (Last updated 1d ago)
Install
Skills CLI
npx skills add k8s-servant/k8s-skills
Asks which skills and agents to install. Just one: npx skills add k8s-servant/k8s-skills --skill k8s-aks-troubleshooting — add -g for every project.
Claude Code
git clone https://github.com/k8s-servant/k8s-skillscp -r "k8s-skills/skills/k8s-aks-troubleshooting" ~/.claude/skills/
Copies the k8s-aks-troubleshooting skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add k8s-servant/k8s-skills
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
k8s-aks-troubleshooting
Use when a problem is specific to Azure Kubernetes Service (AKS): a cluster or node pool in "Failed" state, an upgrade or scale that fails ("UpgradeFailed", "violate the pod's disruption budget", "QuotaExceeded", "AllocationFailed"), a LoadBalancer Service stuck at <pending> ("SyncLoadBalancerFailed", "AuthorizationFailed"), an Azure Disk or Files PVC that fails ("ProvisioningFailed", "volume nod…
skills/k8s-aks-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-api-troubleshooting
Use when the Kubernetes API server itself refuses or fails a request, before any controller acts on it: "failed calling webhook", "admission webhook ... denied the request", "ValidatingAdmissionPolicy ... denied request", a ReplicaSet with FailedCreate and no pods, an APIService "False (ServiceNotFound)", "FailedDiscoveryCheck" or "MissingEndpoints", "unable to retrieve the complete list of serve…
skills/k8s-api-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-argocd-troubleshooting
Use when Argo CD does not deploy or update an application in Kubernetes: an Application that is OutOfSync, Unknown, Degraded, Missing or Progressing, a ComparisonError ("app path does not exist", "unable to resolve ... to a commit SHA"), an InvalidSpecError ("do not match any of the allowed destinations in project"), a sync that fails ("one or more objects failed to apply"), auto-sync that never…
skills/k8s-argocd-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-autoscaling-troubleshooting
Use when Kubernetes autoscaling does not scale as expected: a HorizontalPodAutoscaler whose TARGETS show "<unknown>", "missing request for cpu", "unable to get metrics for resource cpu" or "FailedGetResourceMetric", an HPA stuck at maxReplicas ("TooManyReplicas") or not scaling down, "Metrics API not available" from kubectl top, metrics-server not Ready, a KEDA ScaledObject that is not Ready ("Sc…
skills/k8s-autoscaling-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-cert-manager-troubleshooting
Use when cert-manager does not issue or renew a certificate in Kubernetes: a Certificate that stays READY False, a CertificateRequest that is Pending, Denied or Failed, an Issuer or ClusterIssuer that is not Ready ("Error getting keypair for CA issuer"), "Referenced \"Issuer\" not found", ACME Orders or Challenges stuck pending (HTTP-01, DNS-01, rate limits), a certificate that expired or did not…
skills/k8s-cert-manager-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-cilium-troubleshooting
Use when networking fails on a Kubernetes cluster that runs Cilium as its CNI: traffic between pods dropped or timing out after a CiliumNetworkPolicy or CiliumClusterwideNetworkPolicy, "Policy denied" drops in Hubble, DNS that stops resolving after an egress policy, HTTP 403 "Access denied" from an L7 rule, toFQDNs rules that do not match, pods stuck ContainerCreating with "unable to connect to C…
skills/k8s-cilium-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-coredns-troubleshooting
Use when cluster DNS itself misbehaves on Kubernetes: CoreDNS pods in CrashLoopBackOff ("Error during parsing: Unknown directive", "plugin/loop: Loop ... detected"), "reload failed" after a Corefile edit, external names failing while Service names resolve (";; connection timed out; no servers could be reached", SERVFAIL, "plugin/errors: 2 ... i/o timeout"), one domain or stub domain failing, rewr…
skills/k8s-coredns-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-envoy-gateway-troubleshooting
Use when Envoy Gateway (the Gateway API implementation by the Envoy project) does not route traffic in Kubernetes: a Gateway that is not Programmed ("AddressNotAssigned"), an HTTPRoute that is not Accepted ("NoMatchingListenerHostname", "NotAllowedByListeners") or whose ResolvedRefs is False ("BackendNotFound", "RefNotPermitted" without a ReferenceGrant), clients getting 404, 500 or 503 "no healt…
skills/k8s-envoy-gateway-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-envoy-troubleshooting
Use when an Envoy proxy on Kubernetes fails requests: clients get 503 "no healthy upstream", 503 "upstream connect error or disconnect/reset before headers. reset reason: remote connection failure", 404 with an empty body, or 504 "upstream request timeout", access logs show response flags (UH, UF, NR, NC, UT, UO, URX, UC), or Envoy crashes at start ("has unknown fields", "no such field", "route:…
skills/k8s-envoy-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-external-secrets-troubleshooting
Use when External Secrets Operator does not create or update a Kubernetes Secret: an ExternalSecret with SecretSyncedError ("could not get secret data from provider"), SecretOwnedByOther ("target is owned by another ExternalSecret"), SecretMissing or SecretImmutable, a SecretStore or ClusterSecretStore that is not Ready (InvalidProviderConfig, "unable to validate store"), a ClusterSecretStore not…
skills/k8s-external-secrets-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-fluent-bit-troubleshooting
Use when Fluent Bit on Kubernetes does not deliver logs: the DaemonSet crashes on a config error ("tried to instance a plugin name that doesn't exist", "unknown configuration property", "configuration file contains errors"), an output fails ("failed to flush chunk", "cannot be retried", "no upstream connections available", "getaddrinfo", "Connection refused"), records arrive without Kubernetes me…
skills/k8s-fluent-bit-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-flux-troubleshooting
Use when Flux does not deploy or update something in Kubernetes: a GitRepository, OCIRepository or HelmRepository that is not Ready ("couldn't find remote ref", "authentication required"), a Kustomization that is not Ready ("kustomization path not found", "kustomize build failed", "dependency ... is not ready", health check timeouts), a HelmRelease that is not Ready (HelmChart "invalid chart refe…
skills/k8s-flux-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-gatekeeper-troubleshooting
Use when OPA Gatekeeper blocks, warns about or fails to police resources in Kubernetes: "admission webhook \"validation.gatekeeper.sh\" denied the request: [constraint] message", warnings from constraints in warn mode, a constraint that should block but only shows violations in audit (dryrun), a ConstraintTemplate that does not compile (ingest_error, rego_parse_error), "no matches for kind" when…
skills/k8s-gatekeeper-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-grafana-troubleshooting
Use when Grafana on Kubernetes fails: the Grafana pod crash-loops after a change to its provisioning ("Datasource provisioning error", "Only one datasource per organization can be marked as default", "failed to parse"), a provisioned dashboard or datasource does not appear ("failed to load dashboard from", sidecar ConfigMap labels), panels show "No data" or the datasource returns "Bad Gateway" or…
skills/k8s-grafana-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-helm-troubleshooting
Use when a Helm install, upgrade or rollback fails or a release is stuck: "UPGRADE FAILED" or "INSTALLATION FAILED", "context deadline exceeded" or "resource ... not ready" after --wait, "another operation (install/upgrade/rollback) is in progress", a release in pending-install, pending-upgrade or failed state, "exists and cannot be imported into the current release: invalid ownership metadata",…
skills/k8s-helm-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-istio-troubleshooting
Use when traffic fails in an Istio service mesh on Kubernetes: HTTP 403 "RBAC: access denied" from an AuthorizationPolicy, 503 "no healthy upstream" or "upstream connect error or disconnect/reset before headers", 404 from a route that does not match, "Connection reset by peer" after PeerAuthentication STRICT, sidecars that are not injected, VirtualService, DestinationRule, Gateway or ServiceEntry…
skills/k8s-istio-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-kyverno-troubleshooting
Use when Kyverno blocks, changes or fails to police resources in Kubernetes: "admission webhook \"validate.kyverno.svc-fail\" denied the request", "resource ... was blocked due to the following policies", "Policy ... failed" from a ValidatingPolicy, a policy that should block but only reports (Audit), PolicyReports with failures, a policy that is not Ready, mutate or generate rules that do nothin…
skills/k8s-kyverno-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-loki-troubleshooting
Use when Grafana Loki on Kubernetes rejects, drops or cannot query logs: clients getting 400, 401 or 429 from /loki/api/v1/push, "write operation failed", "has timestamp too old", "entry too far behind", "Per stream rate limit exceeded", "ingestion rate limit exceeded", "maximum active stream limit exceeded", "no org id" (missing X-Scope-OrgID tenant), Loki crashing at start with "validating conf…
skills/k8s-loki-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-network-troubleshooting
Use when traffic does not reach a workload in Kubernetes although its pods are running: a Service with no endpoints, a wrong selector or targetPort, connection refused or time-outs between pods, DNS names that do not resolve (NXDOMAIN, "server can't find"), a NetworkPolicy blocking traffic, or an Ingress or Gateway API route that does not route. Investigates with kubectl get and describe, asks be…
skills/k8s-network-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-node-troubleshooting
Use when a Kubernetes node is unhealthy or pods will not go onto it: a node NotReady or Unknown, MemoryPressure, DiskPressure or PIDPressure, pods Evicted, pods Pending with "untolerated taint(s)", "Insufficient cpu" or "Insufficient memory" while the node looks idle, a node cordoned (SchedulingDisabled), or the cluster autoscaler not adding or removing nodes. Investigates with kubectl get, descr…
skills/k8s-node-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-opentelemetry-collector-troubleshooting
Use when telemetry (traces, metrics, logs) does not get through the OpenTelemetry Collector on Kubernetes: the collector crashes at start ("invalid configuration", "references receiver ... which is not configured", "unknown type"), applications get "connection refused" on 4317 or 4318 (a receiver listening on localhost, or not in a pipeline), exporters fail ("Exporting failed. Will retry the requ…
skills/k8s-opentelemetry-collector-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-prometheus-troubleshooting
Use when Prometheus on Kubernetes does not collect or alert as expected: a ServiceMonitor or PodMonitor whose targets never appear, targets that are down ("server returned HTTP status 404 Not Found", "connection refused", "context deadline exceeded"), a PrometheusRule that does not load or alerts that do not fire or reach Alertmanager, a Prometheus or Alertmanager custom resource that is not Avai…
skills/k8s-prometheus-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-rbac-troubleshooting
Use when a Kubernetes request is refused by RBAC: "Error from server (Forbidden)", "User ... cannot list resource ... in the namespace" or "at the cluster scope", a ServiceAccount, controller, CI job or person getting 403, a RoleBinding that does not seem to apply (wrong namespace, wrong subject, a ClusterRole bound with a RoleBinding), "is attempting to grant RBAC permissions not currently held"…
skills/k8s-rbac-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-storage-troubleshooting
Use when Kubernetes storage blocks a workload: a PersistentVolumeClaim stuck in Pending, ProvisioningFailed events, a StorageClass that does not exist or a provisioner that cannot provide the access mode, pods Pending with "unbound immediate PersistentVolumeClaims", FailedAttachVolume, FailedMount or Multi-Attach errors, a PVC or PV stuck Terminating or Released, or a volume that is full or will…
skills/k8s-storage-troubleshooting/SKILL.md on GitHub (opens in a new tab) -
k8s-triage
Use when something is wrong in a cluster and it is not yet clear where: "the cluster is broken", "a lot of pods are failing", "users say the app is down", "something is off after the upgrade", or any problem report that names no workload. Sweeps nodes, pods in every namespace, recent Warning events and CPU and memory use, ranks what it finds by severity, proposes a first fix for each issue and na…
skills/k8s-triage/SKILL.md on GitHub (opens in a new tab) -
k8s-workload-troubleshooting
Use when a pod or workload is unhealthy in Kubernetes: pods stuck in Pending, CrashLoopBackOff, ImagePullBackOff or ErrImagePull, containers OOMKilled (exit code 137), failing liveness, readiness or startup probes, pods Running but not Ready, a Deployment rollout that does not progress (ProgressDeadlineExceeded), or a Job or CronJob that fails. Investigates with kubectl get, describe, logs and ev…
skills/k8s-workload-troubleshooting/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.