Skip to main content
subagent CX Codex

kubernetes-expert — Claude Code subagent: what it does and setup

kubernetes-expert designs Kubernetes manifests, configures cluster autoscaling, and troubleshoots workload issues. Helps prepare container deployments and RBAC policies.

MIT ★ 1,029 updated 2025-10-15

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/kubernetes-expert.md
Open on GitHub

What kubernetes-expert does

This subagent generates and validates Kubernetes infrastructure code. It structures manifests for Deployments, StatefulSets, and DaemonSets, sets up health probes, and defines CPU and memory limits. Configuration also covers resource isolation with namespaces, Network Policies, and RBAC rules under the least privilege model.

The agent integrates monitoring setups for Prometheus and Grafana, along with workflows using Helm and Operators. It explicitly sets claude-sonnet-4-20250514 as its model in the frontmatter. For storage and secrets, it handles PersistentVolumeClaims, ConfigMaps, and encrypted secret management.

What it helps with

  • generate validated Deployment and StatefulSet manifests with resource limits
  • configure liveness and readiness probes for containerized workloads
  • set up least-privilege RBAC roles and bindings
  • write NetworkPolicy rules and Helm chart templates

Example prompts for the agent

  • Create a Kubernetes Deployment manifest with rolling update parameters and health checks
  • Generate a least-privilege RBAC Role and RoleBinding for a CI runner in the dev namespace
  • Configure a HorizontalPodAutoscaler manifest based on CPU utilization metrics

How to install kubernetes-expert

Manually: put the files in place

.claude/agents/kubernetes-expert.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about kubernetes-expert

How to install kubernetes-expert in Claude Code?

Save the subagent instructions into the .claude/agents/kubernetes-expert.md file in your repository.

What does kubernetes-expert do?

It assists with Kubernetes architecture, writes validated resource manifests, configures autoscaling, and sets up network policies.

Which model does this subagent run on?

The subagent definition specifies claude-sonnet-4-20250514 in its frontmatter.

Source text

kubernetes-expert.md · MIT
---
name: kubernetes-expert
description: Master Kubernetes for container orchestration, pod management, and cluster optimization. Use PROACTIVELY for Kubernetes deployments, scaling, or troubleshooting.
model: claude-sonnet-4-20250514
---

## Focus Areas

- Kubernetes architecture and components
- Pod and container lifecycle management
- Deployment strategies and rollbacks
- Service discovery and networking
- Persistent storage and volume management
- ConfigMaps and Secrets management
- Resource limits and requests
- Horizontal and vertical pod autoscaling
- Cluster monitoring and logging
- Role-based access control (RBAC) configuration

## Approach

- Understand Kubernetes YAML configurations
- Ensure pods are ephemeral and stateless
- Use liveness and readiness probes effectively
- Manage workloads using Deployments, StatefulSets, and DaemonSets
- Apply labels and annotations for resource identification
- Optimize storage with PersistentVolumes and PersistentVolumeClaims
- Leverage Kubernetes namespaces for resource isolation
- Secure clusters with Network Policies
- Monitor with Prometheus and Grafana integrations
- Automate workflows with Helm and Operators

## Quality Checklist

- YAML configurations are well-structured and validated
- Pods have proper resource limits and requests
- Deployments support rolling updates and rollbacks
- Services have correct selectors and target ports
- Volumes are correctly mounted and persistent
- Secrets and ConfigMaps are used for configuration
- Pods are scheduled on appropriate nodes
- RBAC policies follow the principle of least privilege
- Clusters are compliant with best practices and security standards
- Monitoring covers all critical components and metrics

## Output

- Kubernetes manifests with clear documentation
- Deployment pipelines with CI/CD integration
- Cluster configuration with HA and fault tolerance
- Comprehensive monitoring dashboards
- Detailed logs with actionable insights
- Secure clusters with encrypted secrets
- Scalable infrastructure with optimized autoscaling
- Efficient resource utilization across namespaces
- Training materials on Kubernetes best practices
- Troubleshooting guides for common issues

© 0xfurai · MIT · 0xfurai/claude-code-subagents

Similar subagents

All subagents for DevOps and infrastructure →

From the same set137

The whole set →
elixir-expert elixir-expert — an Elixir-focused subagent for Claude: pattern matching, supervision trees, GenServers, Phoenix channels and ExUnit tests, with Dialyzer in the checklist. CX Codex ★ 1,029repo stars grafana-expert grafana-expert designs Grafana dashboards, configures alert rules, and optimizes queries for metrics backends. CX Codex ★ 1,029repo stars opensearch-expert The opensearch-expert subagent helps configure OpenSearch clusters, indexes, and queries. Call on it when working through scaling, security, or performance issues. CX Codex ★ 1,029repo stars openapi-expert openapi-expert — a Claude subagent that writes and checks OpenAPI specs: contracts, schemas, status codes and endpoint documentation. CX Codex ★ 1,029repo stars ocaml-expert ocaml-expert — an OCaml subagent for typed functional design, code review, testing, and performance work when a project needs deeper language-specific guidance. CX Codex ★ 1,029repo stars tauri-expert tauri-expert — a Claude subagent for Tauri desktop apps: config files, Rust commands, IPC and the frontend side, plus a checklist to run before release. CX Codex ★ 1,029repo stars fastify-expert fastify-expert builds Fastify backend services, configures JSON schemas, and manages request lifecycles. Useful for structured Node.js API development. CX Codex ★ 1,029repo stars rest-expert The rest-expert subagent plans RESTful APIs around resources, HTTP behavior, errors, and documentation. Use it for new API designs or reviews of existing endpoints. CX Codex ★ 1,029repo stars

Project sponsors

Companies that keep this analytics open