Kubernetes Architecture

Use when the user asks for a Kubernetes architecture overview, control plane components, what the kubelet does, kube-proxy modes, how a pod gets scheduled, or rolling update vs blue/green vs canary. Traces kubectl apply to running containers and picks a rollout strategy. Not for etcd/apiserver internals (use kubernetes-internals) or rollout tooling (use devops-progressive-delivery).

45 stars 6 forksDevOps & Cloud

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add j4flmao/agent-skills --skill kubernetes-architecture
Manual install
git clone --depth 1 https://github.com/j4flmao/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/devops/orchestration/kubernetes-architecture ~/.claude/skills/kubernetes-architecture

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Kubernetes Architecture and Deployment Strategies

## Purpose
Give an accurate mental model of the Kubernetes control plane and node components and how they cooperate through the API server, then map release requirements to a deployment strategy.

## Agent Protocol

### Trigger
"kubernetes architecture", "control plane", "kubelet", "kube-proxy modes", "etcd", "how a pod is scheduled", "deployment strategies", "rolling vs blue green vs canary".

### Input Context
- Managed (EKS/GKE/AKS) or self-managed; cluster version.
- Release risk tolerance, traffic management available (ingress/Gateway API, mesh).

### Output Artifact
Explanation and strategy recommendation with manifests. No file unless requested.

### Response Format
```
Component(s): {...} — responsibility
Flow: {kubectl -> apiserver -> etcd -> controller -> scheduler -> kubelet -> CRI}
Strategy: {RollingUpdate|Recreate|blue/green|canary} (why)
Config: {YAML}
```

### Completion Criteria
- [ ] Every component described by what it watches and what it writes.
- [ ] Strategy matches rollback-time and capacity constraints.

## Components
| Component | Runs on | Responsibility |
|---|---|---|
| kube-apiserver | Control plane | Only component that talks to etcd; authn → authz → admission → validation → persistence; serves watches |
| etcd | Control plane (or external) | Consistent key-value store (Raft) for all cluster state; odd member count (3/5) |
Read the full skill on GitHub

Details

Skill name
kubernetes-architecture
Path
skills/devops/orchestration/kubernetes-architecture/SKILL.md
License
MIT
Repo updated
17 November 2026

FAQ

What does the Kubernetes Architecture skill do?

Use when the user asks for a Kubernetes architecture overview, control plane components, what the kubelet does, kube-proxy modes, how a pod gets scheduled, or rolling update vs blue/green vs canary. Traces kubectl apply to running containers and picks a rollout strategy. Not for etcd/apiserver internals (use kubernetes-internals) or rollout tooling (use devops-progressive-delivery).

How do I install the Kubernetes Architecture skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add j4flmao/agent-skills --skill kubernetes-architecture. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Kubernetes Architecture popular?

It lives in j4flmao/agent-skills, which has 45 GitHub stars and 6 forks.

Related skills

Agent Observability

45

j4flmao/agent-skills

Use when the user asks about agent observability, tracing agent reasoning, debugging an agent loop, OpenTelemetry GenAI spans for LLM calls, LLM cost tracking per agent, agent audit logs or hallucination/eval monitoring in production. Produces instrumentation config, trace schema, dashboards, alerts and cost attribution. Not for generic service tracing without LLMs (use devops-opentelemetry).

DevOps & Cloud

AI Agent Architectures

45

j4flmao/agent-skills

Use when the user asks to build an AI agent, design an agent that calls tools and keeps memory, write an agent system prompt or pick an agent framework (Claude Agent SDK, OpenAI Agents SDK, LangGraph). Produces an architecture brief covering loop, tools, memory, guardrails and evals, routing depth to child skills. Not for workflow patterns (use ai-agentic-workflows).

AI, LLMs & Agents

AI Agent Core Loop

45

j4flmao/agent-skills

Use when the user asks about the agent loop, ReAct vs plan-and-solve, re-planning, Reflexion, an agent stuck in a loop, max iterations or termination conditions. Produces a loop spec or patch with state, success predicate, caps and no-progress detection. Not for overall agent design (use ai-agent-architectures) or tool schemas (use tool-calling-principles).

AI, LLMs & Agents

Kubernetes Internals

45

j4flmao/agent-skills

Use when the user asks about Kubernetes internals, etcd Raft and compaction, resourceVersion, the watch cache, informers and list-watch, the admission chain, kubelet pod lifecycle, CRI/CNI/CSI, or why a pod is OOMKilled at the cgroup level. Explains the control plane for debugging. Not for an overview (use kubernetes-architecture) or writing operators (use devops-kubernetes-operators).

DevOps & Cloud

Kubernetes

45

j4flmao/agent-skills

Use when the user asks about Kubernetes cluster admin, a deployment that keeps getting OOMKilled, CrashLoopBackOff, RBAC, Pod Security Admission, NetworkPolicies, Ingress or Gateway API, StorageClasses, cluster upgrades, or etcd backup. Produces cluster fixes and configs. Not for control-plane internals (use kubernetes-internals) or workload patterns (use cloud-native-kubernetes-patterns).

DevOps & Cloud

Longhorn

45

j4flmao/agent-skills

Use when the user asks about Longhorn on Kubernetes, Longhorn volumes and replicas, backup targets (S3 or NFS), recurring snapshots, disaster recovery volumes, the V2 data engine, Longhorn performance, or degraded volumes. Produces Longhorn install, StorageClass and backup configs. Not for Ceph or SAN design (use storage-infrastructure).

DevOps & Cloud

Browse the most popular Claude skills, all devops & cloud skills, or write your own with the skills generator.