Multi-agent Kubernetes skills powered by kubectl-mcp-server (270+ tools).
This directory contains Kubernetes operational skills in Claude format (SKILL.md). Use SkillKit to convert to your preferred AI agent format.
Skills follow the agenstskills.com specification with enhanced frontmatter, activation triggers, and priority rules.
kubernetes-skills/
├── README.md
├── claude/ # Source skills (26 skills)
│ ├── k8s-core/ # Pods, namespaces, configmaps, secrets
│ ├── k8s-networking/ # Services, ingress, network policies
│ ├── k8s-storage/ # PVCs, storage classes, volumes
│ ├── k8s-deploy/ # Deployments, StatefulSets, DaemonSets
│ │ ├── SKILL.md
│ │ ├── references/ # Strategy documentation
│ │ └── examples/ # Runnable YAML manifests
│ ├── k8s-operations/ # kubectl apply/patch/delete/exec
│ ├── k8s-helm/ # Helm charts and releases
│ │ ├── SKILL.md
│ │ ├── references/ # Chart structure docs
│ │ └── scripts/ # Executable scripts
│ ├── k8s-diagnostics/ # Metrics, health checks
│ ├── k8s-troubleshoot/ # Debug pods, nodes, workloads
│ │ ├── SKILL.md
│ │ └── references/ # Decision trees, error guides
│ ├── k8s-incident/ # Emergency runbooks
│ ├── k8s-security/ # RBAC, service accounts
│ ├── k8s-policy/ # Kyverno/Gatekeeper policies
│ ├── k8s-certs/ # Cert-manager certificates
│ ├── k8s-gitops/ # Flux and ArgoCD
│ ├── k8s-rollouts/ # Argo Rollouts/Flagger
│ ├── k8s-autoscaling/ # HPA, VPA, KEDA
│ │ ├── SKILL.md
│ │ └── examples/ # HPA and KEDA manifests
│ ├── k8s-cost/ # Cost optimization
│ ├── k8s-backup/ # Velero backup/restore
│ ├── k8s-multicluster/ # Multi-cluster operations
│ ├── k8s-capi/ # Cluster API lifecycle
│ ├── k8s-kubevirt/ # KubeVirt VMs
│ ├── k8s-service-mesh/ # Istio traffic management
│ ├── k8s-cilium/ # Cilium/Hubble observability
│ ├── k8s-vind/ # vCluster virtual clusters
│ │ ├── SKILL.md
│ │ └── references/ # Workflow documentation
│ ├── k8s-kind/ # kind local clusters
│ │ ├── SKILL.md
│ │ └── references/ # Configuration examples
│ ├── k8s-browser/ # Browser automation
│ └── k8s-cli/ # MCP server CLI
Each skill follows the enhanced agenstskills.com specification:
---
name: k8s-troubleshoot
description: Debug Kubernetes pods, nodes, and workloads...
license: Apache-2.0
metadata:
author: rohitg00
version: "1.0.0"
tools: 15
category: observability
---
# Kubernetes Troubleshooting
## When to Apply
Use this skill when:
- User mentions: "debug", "troubleshoot", "failing", "crash"
- Pod states: Pending, CrashLoopBackOff, ImagePullBackOff
- Keywords: "logs", "events", "describe"
## Priority Rules
| Priority | Rule | Impact | Tools |
|----------|------|--------|-------|
| 1 | Check pod status first | CRITICAL | `get_pods` |
| 2 | View recent events | CRITICAL | `get_events` |
| 3 | Inspect logs | HIGH | `get_pod_logs` |
## Quick Reference
| Task | Tool | Example |
|------|------|---------|
| Get pods | `get_pods` | `get_pods(namespace)` |# Copy skills to Claude
cp -r kubernetes-skills/claude/* ~/.claude/skills/Install SkillKit:
npm install -g skillkitConvert to your agent:
# Convert all skills to Cursor format
skillkit translate kubernetes-skills/claude --to cursor --output .cursor/rules/
# Convert all skills to Codex format
skillkit translate kubernetes-skills/claude --to codex --output ./
# Convert all skills to any supported agent
skillkit translate kubernetes-skills/claude --to <agent> --output <dir>Supported agents: cursor, codex, gemini-cli, github-copilot, goose, kilo, roo, windsurf, amp, universal
Each SKILL.md file contains:
- YAML frontmatter with
nameanddescription - Markdown content with tool references and workflows
Convert manually by copying the content to your agent's format:
| Agent | Target File |
|---|---|
| Cursor | .cursor/rules/<skill>.mdc |
| Codex | AGENTS.md |
| GitHub Copilot | .github/copilot-instructions.md |
| Windsurf | .windsurf/rules/<skill>.md |
| Goose | .goose/instructions.md |
| Category | Skills |
|---|---|
| Core Resources | k8s-core, k8s-networking, k8s-storage |
| Workloads | k8s-deploy, k8s-operations, k8s-helm |
| Observability | k8s-diagnostics, k8s-troubleshoot, k8s-incident |
| Security | k8s-security, k8s-policy, k8s-certs |
| GitOps | k8s-gitops, k8s-rollouts |
| Scaling | k8s-autoscaling, k8s-cost, k8s-backup |
| Multi-Cluster | k8s-multicluster, k8s-capi, k8s-kubevirt |
| Networking | k8s-service-mesh, k8s-cilium |
| Development | k8s-vind, k8s-kind |
| Tools | k8s-browser, k8s-cli |
| Category | Tools | Examples |
|---|---|---|
| Core | 17 | get_pods, get_namespaces, get_configmaps, get_secrets |
| Deployments | 10 | scale_deployment, rollback_deployment, set_deployment_image |
| Networking | 8 | get_services, get_ingresses, get_network_policies |
| Storage | 3 | get_pvcs, get_storage_classes, get_persistent_volumes |
| Security | 10 | get_cluster_roles, get_role_bindings, get_service_accounts |
| Helm | 16 | install_helm_chart, upgrade_helm_release, rollback_helm_release |
| Operations | 14 | kubectl_apply, kubectl_delete, kubectl_patch, kubectl_exec |
| Diagnostics | 3 | compare_namespaces, get_resource_metrics, cluster_health_check |
| Cost | 8 | get_resource_quotas, find_overprovisioned, unused_resources |
| GitOps | 7 | flux_reconcile_tool, argocd_sync_tool, argocd_app_status |
| Cert-Manager | 9 | certmanager_certificates_list, certmanager_issuers_list |
| Policy | 6 | kyverno_clusterpolicies_list, gatekeeper_constraints_list |
| Backup | 11 | velero_backups_list, velero_backup_create, velero_restore_create |
| KEDA | 7 | keda_scaledobjects_list, keda_scaledjobs_list |
| Cilium | 8 | cilium_policies_list, hubble_flows_query |
| Rollouts | 11 | rollout_promote, rollout_abort, flagger_canaries_list |
| Cluster API | 11 | capi_clusters_list, capi_machines_list |
| KubeVirt | 13 | kubevirt_vms_list, kubevirt_vm_start, kubevirt_vm_migrate |
| Istio | 10 | istio_virtualservices_list, istio_analyze, istio_proxy_status |
| vCluster (vind) | 14 | vind_create_cluster, vind_connect, vind_pause |
| kind | 32 | kind_create_cluster, kind_load_image, kind_get_kubeconfig |
| Browser | 26 | browser_open, browser_screenshot, browser_click (optional) |
| UI | 6 | ui_dashboard, ui_pod_table, ui_deployment_chart |
| Resource | Description |
|---|---|
cluster://status |
Cluster health and version info |
namespaces://list |
All namespaces with status |
pods://{namespace} |
Pods in a namespace |
deployments://{namespace} |
Deployments in a namespace |
services://{namespace} |
Services in a namespace |
events://{namespace} |
Recent events |
nodes://list |
Node status and capacity |
contexts://list |
Available kubeconfig contexts |
| Prompt | Description |
|---|---|
troubleshoot-pod |
Debug a failing pod |
deploy-application |
Deploy with best practices |
security-audit |
RBAC and policy review |
cost-optimization |
Find savings opportunities |
incident-response |
Emergency debugging |
helm-workflow |
Helm chart operations |
gitops-sync |
Flux/ArgoCD reconciliation |
multi-cluster-compare |
Cross-cluster analysis |
# List all tools
kubectl-mcp-server tools -d
# Show tool schema
kubectl-mcp-server tools get_pods
# Search tools
kubectl-mcp-server grep "*helm*"
# Call tool directly
kubectl-mcp-server call get_pods '{"namespace": "default"}'
# Check dependencies
kubectl-mcp-server doctor
# Show/switch context
kubectl-mcp-server context
kubectl-mcp-server context productionEnable with MCP_BROWSER_ENABLED=true:
# Cloud providers
export MCP_BROWSER_PROVIDER=browserbase # or browseruse
export BROWSERBASE_API_KEY=bb_...
# Local browser
browser_open "https://kubernetes.io/docs/"
browser_screenshot "k8s-docs.png"
browser_click "text=Documentation"# Install
pip install kubectl-mcp-server
# Install with UI tools
pip install kubectl-mcp-server[ui]
# Run (HTTP transport)
kubectl-mcp-server serve --transport streamable-http --port 8000
# Run (stdio for Claude Desktop)
kubectl-mcp-server serve
# Verify
kubectl-mcp-server doctor{
"mcpServers": {
"kubectl": {
"command": "kubectl-mcp-server",
"args": ["serve"]
}
}
}docker run -v ~/.kube:/root/.kube rohitghumare64/kubectl-mcp-server:latest- kubectl-mcp-server - 270+ Kubernetes MCP tools
- SkillKit - Universal CLI for AI agent skills
- agenstskills.com - Agent skills specification
- MCP Protocol - Model Context Protocol spec
Apache-2.0