initMAX/zabbix-ai-skills

Zabbix AI Skills는 일반적인 Zabbix 작업을 자동화하는 사용 가능한 AI 워크플로우 모음입니다. 각 스킬은 문제 확인부터 공식 Zabbix 저장소에서 템플릿 업그레이드까지 실제 작업을 완료하기 위해 여러 Zabbix MCP Server API 호출을 조정하는 구조화된 프롬프트입니다.

API 매개변수와 호출 체이닝을 수동으로 기억할 필요 없이, 단순히 /zabbix-status를 입력하면 전체 운영 개요를 얻을 수 있습니다.

스킬은 Claude Code, VS Code Copilot, ChatGPT, Cursor, Cline, JetBrains AI 등 모든 MCP 호환 AI 클라이언트에서 작동합니다.

You (AI client) → Skill prompt → MCP tools → Zabbix API → Results

• 사용자가 스킬을 호출합니다 (슬래시 명령어, 사용자 지정 지침 또는 프롬프트 붙여넣기 방식).
• AI가 단계별 지침과 함께 스킬을 로드합니다.
• 여러 Zabbix MCP Server 도구를 자동으로 실행합니다.
• 구조화되고 사람이 읽기 쉬운 결과를 얻습니다.

/zabbix-maintenance — 유지보수 윈도우를 쉽게 설정하기

간단한 대화를 통해 유지보수 윈도우를 생성, 목록화 또는 제거할 수 있습니다. AI가 호스트/그룹 이름 해결, 타임스탬프 계산 및 데이터 수집 설정 구성 등 모든 복잡성을 처리합니다.

> /zabbix-maintenance create
AI: 어떤 호스트나 그룹을 유지보수에 넣어야 할까요?
You: web-prod-01과 web-prod-02
...

/zabbix-add-host — 대화형 호스트 온보딩

새로운 호스트를 추가하는 과정을 단계별로 안내하는 마법사입니다. 호스트 이름, IP, 에이전트 유형, 그룹, 템플릿을 설정합니다. 사용 가능한 그룹과 템플릿을 Zabbix에서 조회하여 실제 옵션 중에서 선택할 수 있게 하고, 이후 호스트를 생성하고 도달 가능 여부를 확인합니다.

> /zabbix-add-host
AI: 호스트 이름은 무엇인가요? (기술명)
You: db-replica-03
...

/zabbix-template-upgrade — 공식 Zabbix 저장소에서 업그레이드

Zabbix 버전을 자동 감지하고, git.zabbix.com에서 최신 템플릿을 가져오며, 변경 사항을 비교하고, 현재 버전을 백업한 후, 업그레이드를 가져옵니다. 종속된 템플릿도 자동으로 처리합니다.

/zabbix-template-upgrade Linux
AI: Zabbix version 7.0.4 감지 → release/7.0 브랜치 사용
Found: templates/os/linux/template_os_linux.yaml
...

**벌크 모드(bulk mode)**도 지원합니다 — /zabbix-template-upgrade all을 실행하여 모든 템플릿의 업데이트 가능 여부를 스캔할 수 있습니다.

/zabbix-anomaly — 이상 감지 (Anomaly Detection)
현재 메트릭 값을 7일 기준선(baseline)과 비교하여 크게 벗어나는 항목을 감지합니다. 급증(spikes)과 비정상적인 하락 모두 플래그 지정합니다.

> /zabbix-anomaly
AI: 이상 징후를 가진 42개 호스트 스캔 중...
CRITICAL ANOMALIES:
...

/zabbix-correlate — 문제 상관관계 분석 (Problem Correlation)
문제 전반에 걸쳐 패턴을 찾습니다 — 연쇄 장애(cascading failures), 공유된 근본 원인, 반복되는 클러스터. 어떤 문제가 연결되어 있는지, 그리고 무엇이 먼저 이를 유발했는지 식별합니다.

> /zabbix-correlate last 24h
AI: 총 28개 문제 중 3개의 상관관계 클러스터 발견
CLUSTER 1 — 네트워크 연쇄 장애 (14:22–14:25):
...

/zabbix-changelog — 설정 변경 기록 (Configuration Changelog)
감사 로그(audit log)에서 파싱하여 Zabbix 설정에서 누가 무엇을 변경했는지 보여줍니다. 템플릿 연결 해제나 트리거 비활성화와 같은 위험한 변경 사항에 플래그를 지정합니다.

> /zabbix-changelog 24
AI: 지난 24시간 동안 3명의 사용자에 의해 23개 변경 발생
HOSTS (5개 변경):
...

• MCP와 호환되는 모든 AI 클라이언트 (지원되는 클라이언트 참조)
• Zabbix MCP 서버가 설치되어 있고 귀하의 Zabbix 인스턴스에 연결됨
• 필요한 작업에 대한 적절한 Zabbix API 권한

Skills는 MCP 도구 호출을 오케스트레이션하는 구조화된 마크다운 프롬프트입니다. 이들은 Zabbix MCP 서버를 지원하는 모든 AI 클라이언트와 작동합니다.

각 스킬 파일은 독립적인 Markdown으로 구성되어 있으며, 어떤 AI 클라이언트가 실행하든 상관없이 지침이 작동합니다.

• 이 저장소를 클론하세요:

git clone https://github.com/initMAX/zabbix-ai-skills.git

• Claude Code 프로젝트 설정( .claude/settings.json)에 스킬 디렉터리를 등록하세요:

{
"skills": {
"directory": "/path/to/zabbix-ai-skills/skills"
...

• MCP 설정에서 Zabbix MCP Server가 구성되었는지 확인하세요:

{
"mcpServers": {
"zabbix": {
...

• 스킬 사용을 시작하세요:

> /zabbix-status
> /zabbix-investigate web-prod-01
> /zabbix-template-upgrade Linux

• 이 저장소를 클론하고
• Zabbix MCP Server를 AI 클라이언트에 연결하세요 (MCP 서버 문서를 참조)
• skills/에서 원하는 스킬 파일을 열고 그 내용을 AI 채팅에 붙여넣거나 시스템 프롬프트/커스텀 지침으로 사용하세요.

스킬 로드가 완료되면, 직접 사용하거나 자연어와 결합하여 사용할 수 있습니다.

각 스킬은 YAML 프론트매터를 가진 Markdown 파일입니다. skills/ 디렉터리에 새로운 .md 파일을 생성하세요:

---
name: my-custom-skill
description: 이 스킬이 하는 일을 한 줄로 설명합니다
...

AI는 단계를 따라 MCP 도구 호출을 자동으로 오케스트레이션(orchestrates)합니다. Claude Code에서는 스킬이 /슬래시 명령어 형태로 호출됩니다. 다른 클라이언트에서는 Markdown 콘텐츠를 대화에 직접 붙여넣거나 시스템 프롬프트로 사용하십시오.

AGPL-3.0 — 자세한 내용은 LICENSE를 참조하십시오.