k8s-gateway-api-troubleshooting
Use when Gateway API objects in Kubernetes do not route, whatever the implementation: a GatewayClass stuck "Waiting for controller" or not Accepted, a Gateway with no address or PROGRAMMED Unknown or False ("ListenersNotValid", "AddressNotAssigned"), a listener that is not Programmed ("InvalidCertificateRef", "ProtocolConflict", "InvalidRouteKinds", "RefNotPermitted"), an HTTPRoute, GRPCRoute or TLSRoute that is not Accepted ("NoMatchingParent", "NotAllowedByListeners", "NoMatchingListenerHostname") or has no status at all, ResolvedRefs False ("BackendNotFound", "RefNotPermitted" without a ReferenceGrant), ListenerSets, BackendTLSPolicy, and Gateway API CRD versions or channels that do not match. Investigates with kubectl get and describe, and proposes fixes. Reads first and asks before changing anything.
- License
- Apache-2.0
Pinned to revision 6919c56810a3, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/k8s-gateway-api-troubleshooting/SKILL.md
- skills/k8s-gateway-api-troubleshooting/.claude-plugin/plugin.json
- skills/k8s-gateway-api-troubleshooting/references/gateways-and-listeners.md
- skills/k8s-gateway-api-troubleshooting/references/routes.md
Every link opens the file at its source, pinned to the revision this page describes.