kubernetes-operations — community kubernetes-operations, hippocampus, community, ide skills, Claude Code, Cursor, Windsurf

v1.0.0
GitHub

About this Skill

Perfect for Cloud Agents needing advanced Kubernetes monitoring and debugging capabilities. Mirror of hippocampus

hippocampus-dev hippocampus-dev
[0]
[0]
Updated: 3/5/2026

Agent Capability Analysis

The kubernetes-operations skill by hippocampus-dev is an open-source community AI agent skill for Claude Code and other IDE workflows, helping agents execute tasks with better context, repeatability, and domain-specific guidance.

Ideal Agent Persona

Perfect for Cloud Agents needing advanced Kubernetes monitoring and debugging capabilities.

Core Value

Empowers agents to visualize cluster metrics using Grafana, manage deployments with ArgoCD, and troubleshoot pod startup failures using kubectl, streamlining Kubernetes operations with tools like Grafana and kubectl.

↓ Capabilities Granted for kubernetes-operations

Debugging pod startup failures
Monitoring cluster metrics with Grafana
Managing deployments with ArgoCD

! Prerequisites & Limits

  • Requires minikube setup
  • Needs access to Kubernetes cluster
  • ArgoCD selfHeal must be disabled before manual changes
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

kubernetes-operations

Install kubernetes-operations, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md
Readonly
  • Access Grafana at https://grafana.minikube.127.0.0.1.nip.io
  • Disable ArgoCD selfHeal before manual changes, re-enable after

Debugging

InvestigatingToolEntry Point
Traces, metrics, logs, profilesGrafanahttps://grafana.minikube.127.0.0.1.nip.io
Pod startup failures, eventskubectlkubectl get events -n <namespace>
In-container process/networkkubectl debugEphemeral container

Observability Investigation (via Grafana)

Use Grafana for all observability signals. Do NOT query backends (Tempo, Mimir, Loki) directly.

  1. Get query parameters - Check cluster/manifests/<app>/ for namespace, labels, OTEL_SERVICE_NAME (see Queries for parameter locations)
  2. Open Grafana - Access https://grafana.minikube.127.0.0.1.nip.io in browser
  3. Select datasource and query - Use appropriate signal:
SignalBackendDatasourceQuery LanguageUse Case
TracesTempoTempoTraceQLRequest flow, latency, access destinations
MetricsMimir (Prometheus)MimirPromQLResource usage, HTTP rates, alerting
LogsLokiLokiLogQLError investigation, audit
ProfilesPyroscopePyroscopeFlamegraph UICPU/memory hotspots
ProbesBlackbox ExporterMimirPromQLEndpoint reachability
SymptomSignalQuery Approach
Errors in logsLoki → TempoExtract traceid from logs, trace in Tempo
Latency/5xxTempoSearch traces with status = error
Unknown outbound dependenciesTempoSearch traces, inspect spans for outbound calls
Resource saturationMimirQuery CPU/memory metrics
High CPU/memoryPyroscopeCheck flamegraphs

Pod Direct Investigation (via kubectl)

Use kubectl when Grafana cannot answer the question (e.g., pod not starting, container-level inspection).

SymptomAction
Pod not startingkubectl get events -n <namespace>
CrashLoopBackOffkubectl logs <pod> -n <namespace> --previous
Network connectivitykubectl debug with ephemeral container
Process inspectionkubectl debug with ephemeral container

Ephemeral Container

bash
1kubectl debug <pod-name> -n <namespace> \
2  --profile=restricted \
3  --image=ghcr.io/hippocampus-dev/hippocampus/ephemeral-container:main \
4  --target=<container-name> \
5  -- <command>

Note: Do not use -it flag when executing commands. It causes output streaming issues.

Manual Changes

Required when directly modifying live cluster resources (e.g., kubectl apply, kubectl patch, kubectl delete) outside of the GitOps workflow.

OperationRequires Manual Changes
kubectl apply/patch/deleteYes
Debugging (read-only: logs, events, debug)No
Grafana queriesNo
Editing manifests in repoNo (ArgoCD syncs automatically)

ArgoCD selfHeal Control

ArgoCD reverts manual changes unless selfHeal is disabled first. Always re-enable after.

bash
1# Disable selfHeal
2kubectl patch application <app-name> -n argocd --type=merge \
3  -p '{"spec":{"syncPolicy":{"selfHeal":false}}}'
4
5# Re-enable selfHeal (after work is complete)
6kubectl patch application <app-name> -n argocd --type=merge \
7  -p '{"spec":{"syncPolicy":{"selfHeal":true}}}'

Observability Stack Manifests

ComponentPath
Grafanacluster/manifests/grafana/
Tempocluster/manifests/tempo/
Mimircluster/manifests/mimir/
Lokicluster/manifests/loki/
Pyroscopecluster/manifests/pyroscope/
Prometheuscluster/manifests/prometheus/
Fluentdcluster/manifests/fluentd/
OpenTelemetrycluster/manifests/otel-agent/, cluster/manifests/otel-collector/

Reference

If writing observability queries: See Queries

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is kubernetes-operations?

Perfect for Cloud Agents needing advanced Kubernetes monitoring and debugging capabilities. Mirror of hippocampus

How do I install kubernetes-operations?

Run the command: npx killer-skills add hippocampus-dev/hippocampus/kubernetes-operations. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for kubernetes-operations?

Key use cases include: Debugging pod startup failures, Monitoring cluster metrics with Grafana, Managing deployments with ArgoCD.

Which IDEs are compatible with kubernetes-operations?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for kubernetes-operations?

Requires minikube setup. Needs access to Kubernetes cluster. ArgoCD selfHeal must be disabled before manual changes.

↓ How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add hippocampus-dev/hippocampus/kubernetes-operations. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use kubernetes-operations immediately in the current project.

Related Skills

Looking for an alternative to kubernetes-operations or another community skill for your workflow? Explore these related open-source skills.

View All

widget-generator

Logo of f
f

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

★ 149.6k
⑂ 0
AI

flags

Logo of vercel
vercel

flags is a Next.js feature management skill that enables developers to efficiently add or modify framework feature flags, streamlining React application development.

★ 138.4k
⑂ 0
Browser

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI