Agent skill
diagnose-network-issue
Diagnose network connectivity issues for pods. Checks DNS resolution, service connectivity, and network policies. Use when pods cannot communicate with other services. Keywords: network issue, DNS, connectivity, service unreachable, network policy, CNI.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/diagnose-network-issue
Metadata
Additional technical details for this skill
- domain
- k8s
- category
- diagnostic
- confidence
- 0.75
- mcp servers
-
[ "kubernetes-mcp-server" ] - requires approval
- NO
SKILL.md
Diagnose Network Issue
Preconditions
Before applying this skill, verify:
- Pod name and namespace are known
- Pod is in Running state
- Network issue symptoms are observed
Actions
1. Get Pod Details
Check pod networking configuration.
mcp_tool: kubernetes-mcp-server/pods_get
params:
name: $pod_name
namespace: $namespace
timeout: 30s
2. Check DNS Resolution
Execute DNS lookup inside the pod.
mcp_tool: kubernetes-mcp-server/pods_exec
params:
name: $pod_name
namespace: $namespace
command: ["nslookup", "kubernetes.default"]
timeout: 30s
3. Check Service Connectivity
Test connection to target service.
mcp_tool: kubernetes-mcp-server/pods_exec
params:
name: $pod_name
namespace: $namespace
command: ["wget", "-O-", "-T5", "$target_service"]
timeout: 30s
4. Get Network Policies
Check if network policies affect the pod.
mcp_tool: kubernetes-mcp-server/resources_list
params:
apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
namespace: $namespace
timeout: 30s
5. Check Pod Events
Look for network-related events.
mcp_tool: kubernetes-mcp-server/events_list
params:
namespace: $namespace
timeout: 30s
Success Criteria
The skill succeeds when:
- DNS resolution works (kubernetes.default resolves)
- No blocking network policies found
- Root cause identified
Failure Handling
If diagnosis is inconclusive:
- Check CNI plugin logs on the node
- Verify kube-proxy is running
- Escalate with gathered diagnostic info
Examples
Input Context:
{
"pod_name": "web-app-abc123",
"namespace": "default",
"target_service": "http://api-service:8080"
}
Output:
{
"dns_working": true,
"service_reachable": false,
"network_policies": ["deny-external"],
"diagnosis": "NetworkPolicy 'deny-external' blocking egress traffic",
"recommendation": "Add egress rule to allow traffic to api-service"
}
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?