k8s-service-connectivity

k8s-service-connectivity is a skill for Claude Code, Codex from kudig-io/kudig-database. It costs 0 tokens per session (6,994 once invoked), scanned A, original, Apache-2.0.

A troubleshooting guide for Kubernetes service connectivity, where services provide stable network access to groups of running containers. It focuses on missing endpoints, selector mismatches, network policies, and kube-proxy problems.

In plain words
What is it for?
Use it to investigate service connections involving endpoints, selectors, NetworkPolicy rules, or kube-proxy.
Why use it?
It helps narrow down why a Kubernetes service cannot reach the containers it is meant to expose.

Skill for Claude CodeCodex

Which agent this was written for is unclear — built for openclaw. Also seen: built for openclaw.

Good fit Use it to investigate service connections involving endpoints, selectors, NetworkPolicy rules, or kube-proxy.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/kudig-io/kudig-database/k8s-service-connectivity
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add kudig-io/kudig-database --skill k8s-service-connectivity
Clone the repo
git clone --depth 1 https://github.com/kudig-io/kudig-database

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for k8s-service-connectivity

README.md
[![agentmods](https://agentmods.dev/badge/skills/kudig-io/kudig-database/k8s-service-connectivity/github.svg)](https://agentmods.dev/skills/kudig-io/kudig-database/k8s-service-connectivity)
Your own site
<a href="https://agentmods.dev/skills/kudig-io/kudig-database/k8s-service-connectivity"><img src="https://agentmods.dev/badge/skills/kudig-io/kudig-database/k8s-service-connectivity/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for k8s-service-connectivity

Your own site · 80×15
<a href="https://agentmods.dev/skills/kudig-io/kudig-database/k8s-service-connectivity"><img src="https://agentmods.dev/badge/skills/kudig-io/kudig-database/k8s-service-connectivity.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 6,994 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00000 $0.06994
Opus 5.5 $0.00000 $0.02798
Sonnet 5.5 $0.00000 $0.01399
Haiku 4.5 $0.00000 $0.00699

Measured 1mo ago against content hash 0a94c8f5a710, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

k8s-service-connectivity scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/diagnose-quick.sh, scripts/verify-service.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

| S1 | 连接 Service IP 超时 | `curl <cluster-ip>:<port>` | 0.90 |
19-故障诊断/08-技能体系/skill-set/k8s-service-connectivity/SKILL.md · 590 lines

How it starts

The opening of the file, as written. The whole thing — 590 lines — stays where its author put it; the contents beside it link to each section on GitHub.

生产环境安全提示

本文档包含可直接执行的运维命令。执行前请确认:当前目标集群与 Namespace 是否正确;是否具备足够的 RBAC 权限;是否已在非生产环境验证。命令风险等级标注:🔴 高风险(可能造成数据丢失或服务中断)、🟡 中风险(会修改集群状态,但通常可回滚)、🟢 低风险/只读(信息收集,无副作用)。

[[service|Service]] 连通性问题诊断与修复

概述

Service 连通性问题通常由 Endpoints 缺失、Selector 不匹配、[[networkpolicy|NetworkPolicy]] 阻断或 kube-proxy 异常引起。

症状识别

# 症状描述 检测方法 置信度
S1 连接 Service IP 超时 curl <cluster-ip>:<port> 0.90
S2 Endpoints 为空 kubectl get endpoints <svc> 0.95
S3 后端 Pod 未 Ready `kubectl get [[Pods pods]] -l `

修复动作

低风险修复

# 修复动作 命令
R1 修正 Service Selector kubectl patch svc <svc> -p '{"spec":{"selector":{"app":"correct-label"}}}'
R2 重启 kube-proxy `kubectl rollout restart [[DaemonSet
R3 删除并重建 Service kubectl delete svc && kubectl apply -f service.yaml

验证修复

./scripts/verify-service.sh <namespace> <service-name>

远程顾问信息收集

作为远程顾问,我无法直接连接你的集群。请帮我收集以下信息,我会根据你提供的内容给出准确的诊断建议。

第一步:快速确认(30 秒内回答)

  1. 影响范围:这个问题影响多少个节点 / Pod / 命名空间?
  2. 紧急程度:业务是否已中断?是否有用户投诉?
  3. 发生时间:问题是突然发生还是逐渐恶化?最近是否有变更?

第二步:关键信息(请提供你能获取的)

  1. kubectl 版本:kubectl version --short 的输出
  2. K8s 集群版本:kubectl get nodes -o wide 中的 VERSION 列
  3. 节点状态:控制平面节点是否正常?工作节点是否正常?

第三步:诊断信息(按需补充)

如果以下命令你无法执行,请直接告诉我「无法执行」,我会提供替代方案。

  1. 相关组件日志:kubectl logs -n <namespace> <pod> 的最后 30 行
  2. 节点资源:kubectl top nodes 或 kubectl describe node <node> 的 Capacity/Allocated resources
  3. 近期变更:最近 24 小时是否有部署、扩缩容、配置变更?

如果信息不足

如果你目前只能提供部分信息,请从第一步开始。我会根据已有信息先给出初步判断,并告诉你还需要收集什么。

替代沟通方式:如果你不方便执行命令,也可以直接描述你看到的页面/告警内容,我会帮你解读。

命令替代方案

如果你无法执行以下命令,请参考对应的替代方案。

通用替代方案

原命令 无法执行的原因 替代方案 A 替代方案 B
kubectl get pods 无 kubectl 权限 通过集群管理控制台查看 Pod 列表 请有权限的同事执行并截图
kubectl logs <pod> 无日志权限 查看应用自身的日志文件(/var/log/) 使用日志聚合系统(如 ELK/Loki)查询
kubectl describe node <node> 无节点查看权限 查看监控系统的节点仪表盘 使用 kubectl get node -o yaml(如权限允许)
ssh <node> 无法 SSH 到节点 使用 kubectl debug node/<node> -it --image=busybox 通过跳板机访问:ssh -J bastion <node>
systemctl status kubelet 无法进入节点 查看节点上的 kubelet 日志:kubectl logs -n kube-system <kubelet-pod> 查看容器运行时日志
docker/crictl 无容器运行时权限 使用 kubectl exec 进入容器检查 查看容器运行时的事件

Read the full file on GitHub · 590 lines

Files

What ships with it

7 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago Changed · +19 lines 0a94c8f5a710
  2. 1mo ago First seen · 571 lines · 0 tokens per session scan A 27ecb1f1e64d

Subscribe to this mod's changes

k8s-service-connectivity is a skill published in the GitHub repository kudig-io/kudig-database (6 stars, last pushed yesterday), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 6,994 tokens. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.