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 server APIs", a namespace stuck in Terminating, "no matches for kind" or "ensure CRDs are installed first", "strict decoding error: unknown field", a conversion webhook failure, "You must be logged in to the server (Unauthorized)", 429 "too many requests", "etcdserver:" errors, "Request entity too large" or "metadata.annotations: Too long". Investigates with kubectl get, describe, events and the health endpoints, and proposes fixes. Reads first and asks before changing anything.
- License
- Apache-2.0
Pinned to revision ce7de97330d7, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/k8s-api-troubleshooting/SKILL.md
- skills/k8s-api-troubleshooting/.claude-plugin/plugin.json
- skills/k8s-api-troubleshooting/references/admission.md
- skills/k8s-api-troubleshooting/references/auth-load-storage.md
- skills/k8s-api-troubleshooting/references/discovery-crds-deletion.md
Every link opens the file at its source, pinned to the revision this page describes.