Kstack: Claude Code를 위한 쿠버네티스 모니터링 및 문제 해결 스킬 팩

Kstack은 Claude Code(및 기타 AI 코딩 에이전트)를 위한 스킬 팩으로, Kubernetes 클러스터를 모니터링하고 문제를 해결하기 위한 일련의 슬래시 명령을 제공합니다. 기존의 kubeconfig 및 RBAC 권한을 활용하며, kubectl, Kubetail, Trivy, Pluto와 같은 표준 도구를 실행한 결과를 LLM에 전달하여 빠르고 토큰 효율적인 응답을 목표로 합니다.

주요 스킬

• /cluster-status — 상태 스냅샷 (파드 재시작, 노드 상태, 리소스 압박)
• /events — 심각도별 최근 이벤트
• /investigate — 이벤트, 로그 및 관련 리소스에 대한 근본 원인 분석
• /logs — 자연어를 로그 조회로 변환하는 공유 tmux 세션 (Kubetail 사용)
• /metrics — 파드, 노드, 워크로드의 CPU, 메모리 및 기타 리소스 메트릭
• /exec — 파드, 노드 또는 임시 디버그 컨테이너로의 공유 tmux 셸
• /audit-security — RBAC, 파드 보안 태세, 권한 강화
• /audit-network — NetworkPolicy, Service, Ingress, GatewayAPI, DNS 및 암호화 점검
• /audit-cost — 요청 대비 사용량, 과도한 프로비저닝, 유휴 용량
• /audit-outdated — 오래된 서비스, 알려진 CVE, 가능한 버전 업그레이드
• /cleanup — kstack이 소유한 모든 리소스 제거 (디버그 컨테이너, 파드 복제본, 감시자 작업)
• /forget — 로컬 캐시 및 클러스터 지식 초기화

설치

전역 설치:

curl -sS https://kstack.sh/install | bash

로컬 프로젝트 설치:

curl -sS https://kstack.sh/install | bash -s -- --local

기본적으로 스킬은 kstack-* 접두사가 붙으며, 비활성화하려면 --no-prefix를 사용하세요. 설치 프로그램이 PATH에 있는 에이전트를 자동으로 감지하여 각각 설치합니다. 지원되는 에이전트는 Claude Code, OpenAI Codex CLI (--agent codex), OpenCode (--agent opencode), Cursor (--agent cursor), Factory Droid (--agent factory), Slate (--agent slate), Kiro (--agent kiro), Hermes (--agent hermes)입니다.

작동 방식

모든 스킬은 기본적으로 읽기 전용입니다. 변경은 명시적 확인이 필요합니다. 로컬 kubeconfig 컨텍스트와 RBAC를 따릅니다. 권한이 부족하면 kstack이 문제를 보고합니다. --context <ctx> 같은 전역 플래그는 모든 스킬에서 지원됩니다.

대상 사용자

AI 코딩 에이전트를 사용하며 컨텍스트 전환 없이 Kubernetes 클러스터를 자연어로 빠르게 모니터링하고 디버깅하려는 개발자 및 플랫폼 엔지니어를 대상으로 합니다.