
공식 Elastic 스킬
<p align="center"> <img alt="Elastic 로고" src="https://assets.kitploit.com/production/public/readmes/12587/8e357b6e4cbecb13a462cd8da398525dbe599bb7210c6426f2f1103702561816.png" width="200"> </p> <p align="center"> <a href="https://github.com/elastic/agent-skills/blob/main/LICENSE"><img alt="라이선스" src="https://img.shields.io/badge/license-Apache%202.0-blue"></a> </p> # Elastic Agent Skills Elastic Agent Skills — Elastic을 만든 사람들이 직접 구축한 — 는 네이티브 플랫폼 전문 지식을 AI 코딩 에이전트에 직접 제공합니다. 이는 공식 Agent Skills 라이브러리로, Cursor, GitHub Copilot, Windsurf, Gemini CLI 등과 같은 에이전트형 IDE와 호환됩니다. 스킬은 [Agent Skills](https://agentskills.io/) 오픈 표준을 따릅니다. > [!NOTE] > **기술 프리뷰** > > 이 스킬들은 초기 릴리스 단계에 있으며 활발히 개발 중입니다. 스킬이 견고한 평가와 함께 정립되고 > 모델 환경이 발전함에 따라 변경될 수 있습니다. 업데이트를 자주 확인하세요. ## 소개 이 저장소에는 모든 AI 에이전트가 Elasticsearch, Kibana, Elastic Observability, Elastic Security를 올바르게 다루는 방법을 가르치는 지침, 컨텍스트, 도구의 패키지로 구성된 엄선된 스킬이 포함되어 있습니다. 이미 사용 중인 에이전트 런타임에 이들을 추가하면, 어시스턴트가 구식 패턴 사용을 멈추고 올바르게 작동하기 시작합니다. ## 스킬이란? 스킬은 AI 에이전트가 특정 작업을 반복 가능한 방식으로 완수할 수 있도록 지식과 도구를 제공하는 자체 포함 패키지입니다. 각 스킬은 에이전트가 따르는 메타데이터와 지침이 담긴 `SKILL.md` 파일과 함께 자체 폴더에 위치합니다. Agent Skills 표준에 대한 더 많은 배경 정보는 [agentskills.io](http://agentskills.io/)를 참조하세요. ## 범위 이 저장소의 스킬은 다음에 중점을 둡니다: - Elasticsearch API와의 상호작용 (검색, 인덱싱, 클러스터 관리) - 알림, 커넥터 등과 같은 Kibana 콘텐츠 구축 및 관리 - Elastic Observability, Elastic Security, Agent Builder를 위한 패턴 <!-- BEGIN-SKILL-TABLE --> ## 사용 가능한 스킬 <details> <summary>Cloud (2)</summary> | 스킬 | 설명 | 버전 | 작성자 | | ----- | ----------- | ------- | ------ | | [cloud-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/cloud/onboarding/SKILL.md) | Elastic Cloud 조직을 온보딩합니다: `elastic` CLI의 Cloud 컨텍스트와 API 키를 구성하고, 기본 리전을 설정한 다음, 사용자를 초대하고, 사전 정의된 또는 사용자 정의 Serverless 프로젝트 역할을 할당하며, Cloud API 키를 생성하거나 폐기합니다. Cloud 인증을 설정할 때 또는 조직 및 그 프로젝트에 대한 사용자 액세스를 부여, 수정, 감사할 때 사용합니다. | 0.3.0 | elastic | | [cloud-provisioning](https://github.com/elastic/agent-skills/blob/main/skills/cloud/provisioning/SKILL.md) | Elastic Cloud 인프라를 프로비저닝하고 운영합니다: Serverless 프로젝트(Elasticsearch, Observability, Security)를 생성, 연결, 업데이트, 삭제하고, 트래픽 필터(IP 및 AWS PrivateLink 네트워크 보안)를 관리하며, Elastic Cloud Hosted 배포의 수명 주기를 관리합니다. Serverless 프로젝트 또는 호스팅 배포를 생성하거나 2일차 운영을 수행할 때, 또는 이들의 네트워크 액세스를 제한할 때 사용합니다. | 0.3.0 | elastic | </details> <details> <summary>Elasticsearch (10)</summary> | 스킬 | 설명 | 버전 | 작성자 | | ----- | ----------- | ------- | ------ | | [elasticsearch-anomaly-detection](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-anomaly-detection/SKILL.md) | API를 통해 Elastic ML 이상 탐지 작업을 생성하고 관리합니다. 인덱스나 데이터 스트림에 작업을 설정하거나, 작업과 데이터피드를 구성하거나, 작업을 열기, 시작 또는 중지할 때 사용합니다. | 1.1.0 | elastic | | [elasticsearch-anomaly-detection-explainer](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-anomaly-detection-explainer/SKILL.md) | Elasticsearch ML 이상 탐지 점수, 모델 동작 및 결과 해석을 설명합니다. 사용자가 점수가 왜 높거나 낮은지, 모델이 어떻게 학습하는지, 숫자가 무엇을 의미하는지, 또는 예상치 못한 이상 점수를 어떻게 문제 해결할지 물을 때 사용합니다. | 0.3.0 | elastic | | [elasticsearch-cluster-health](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-cluster-health/SKILL.md) | 녹색이 아닌 Elasticsearch 클러스터를 진단하고 가장 가능성 높은 단일 원인과 해결 방법을 제시합니다. 운영자가 노란색 또는 빨간색 상태, 할당되지 않은 샤드, 할당 실패를 보고하거나 더 깊은 조사 전에 읽기 전용 트리아지를 원할 때 사용합니다. 복제본 대 프라이머리 영향, 할당 결정자 분류, 데이터 손실 인식을 가르칩니다. | 0.1.0 | elastic | | [elasticsearch-esql](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-esql/SKILL.md) | ES\|QL(Elasticsearch Query Language) 쿼리를 실행합니다. 사용자가 Elasticsearch 데이터를 쿼리하거나, 로그를 분석하거나, 메트릭을 집계하거나, 데이터를 탐색하거나, ES\|QL 결과로 차트와 대시보드를 만들고자 할 때 사용합니다. | 0.10.0 | elastic | | [elasticsearch-index-design](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-index-design/SKILL.md) | 명시된 액세스 패턴에 맞게 Elasticsearch 인덱스 매핑을 설계하고 검토합니다: 올바른 필드 유형, text+keyword 멀티 필드, doc_values 튜닝, 매핑 폭발 방지, 명시적 샤드 설정. 새 인덱스를 생성하거나, 저장소 또는 쿼리 성능을 위해 매핑을 검토하거나, 잘못된 필드 유형을 수정하거나, 사용자가 필드에 대한 검색, 필터, 정렬 또는 집계에 어떤 유형을 사용할지 물을 때 사용합니다. | 0.1.0 | elastic | | [elasticsearch-ingest](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-ingest/SKILL.md) | 필드 유형이 중요한 경우 bulk API와 명시적 매핑을 사용하여 CSV, JSON, NDJSON 파일을 Elasticsearch 인덱스에 로드합니다. 로컬 파일을 일괄 가져오거나, CSV 행이나 JSON 배열을 NDJSON bulk 형식으로 변환하거나, 수집 전에 elastic es info로 클러스터 연결을 확인하거나, 수집 후 문서 수와 매핑을 검증할 때 사용합니다 — Logstash 파이프라인, Beats, 사용자 지정 스크립트 또는 인덱스 간 재인덱싱에는 사용하지 않습니다. | 0.1.3 | elastic | | [elasticsearch-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-onboarding/SKILL.md) | Elasticsearch를 처음 접하는 개발자가 제로에서 작동하는 검색 경험에 도달하도록 돕습니다. 의도 이해, 데이터 매핑, 모범 사례가 내장된 검색 경험 구축 과정을 안내합니다. 사용자가 검색 관련 기능을 구축하려는 의도를 보이거나, 자신의 사용 사례에 대한 Elasticsearch 관련 개념을 묻거나, Elasticsearch 시작에 도움이 필요하다고 표현할 때 사용합니다. | 0.3.0 | elastic | | [elasticsearch-query-optimization](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-query-optimization/SKILL.md) | 느린 Elasticsearch Query DSL 검색을 진단하고 측정된 수정 사항을 제안합니다. 검색이 느리거나, 프로파일 출력에 비용이 큰 절이 표시되거나, 정확히 일치하는 필터가 스코어링 컨텍스트에 있거나, 선행 와일드카드가 지연 시간을 지배할 때 사용합니다. 모든 권장 사항을 검색 프로파일링에 근거하세요 — 스코어링과 무관한 절을 필터 컨텍스트로 이동하고, 선행 와일드카드를 제거하고, 개선을 확인하기 위해 다시 프로파일링하세요. | 0.1.0 | elastic | | [elasticsearch-reindex](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-reindex/SKILL.md) | 성능을 위한 Elasticsearch 재인덱싱을 안내합니다: 로컬 및 원격, 슬라이싱, 스로틀링, 작업 API. 인덱스를 복사하거나 마이그레이션하거나, 매핑을 변경하거나, 재인덱싱 중에 변환할 때 사용합니다. | 0.2.0 | elastic | | [elasticsearch-search-relevance](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-search-relevance/SKILL.md) | 콘텐츠 및 카탈로그 인덱스에 대한 Elasticsearch 검색 관련성을 개선합니다. 쿼리 규칙(올바른 규칙 유형, 조건, 규칙-쿼리 연결)으로 결과를 고정하거나 승격하고, 인덱스 매핑에 기반한 multi_match, 필드 부스트, 분석으로 유기적 순위를 조정합니다. 검색 결과의 순위가 낮거나, 특정 문서가 특정 쿼리에 대해 최상위에 나타나야 하거나, 사용자가 전문 검색 매칭 조정을 요청할 때 사용합니다. ES\|QL 분석, 인덱스 수집, 클러스터 상태에는 사용하지 않습니다. | 0.1.0 | elastic | </details> <details> <summary>Kibana (7)</summary> | 스킬 | 설명 | 버전 | 작성자 | | ----- | ----------- | ------- | ------ | | [kibana-agent-builder](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-agent-builder/SKILL.md) | Kibana Agent Builder 에이전트와 사용자 정의 도구를 생성하고 관리합니다. Agent Builder에서 에이전트나 도구를 생성, 업데이트, 삭제, 테스트 또는 검사하라는 요청을 받았을 때, 또는 사용자가 이미 존재하는 에이전트나 도구가 무엇인지 이해하고자 할 때 사용합니다. | 0.3.0 | elastic | | [kibana-alerting-rules](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-alerting-rules/SKILL.md) | Kibana 알림 규칙을 생성하고 관리합니다. 규칙 생성, 업데이트 또는 수명 주기 관리(활성화, 비활성화, 음소거, 스누즈), 메트릭 임계값 규칙 유형과 매개변수 선택, 또는 태그 필터를 사용한 읽기 전용 찾기/목록 조회 시 사용합니다. | 0.3.0 | elastic | | [kibana-anomaly-detection](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-anomaly-detection/SKILL.md) | Elastic ML 이상 탐지 — 조사/RCA, 점수 설명, 작업 수명 주기 문제 해결, 작업 운영. "무엇이 고장 났나?"/"어떤 엔터티인가?"/RCA, "왜 점수가 높거나 낮은가?"/재정규화, "데이터피드가 중지됨"/"메모리 제한"/hard_limit에 답하거나 ML 이상 탐지 작업을 구성할 때 사용합니다. 결과는 `.ml-anomalies-*`에서, 작업 상태는 ML REST API에서 읽습니다. | 0.3.0 | elastic | | [kibana-cases](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-cases/SKILL.md) | Elastic Security, Observability, Stack Management 전반에 걸쳐 조사 및 사고 케이스를 관리합니다 — 댓글, 알림, 이벤트, 관찰 가능 항목(IOC)으로 케이스를 생성, 검색, 업데이트, 보강합니다. 사고를 추적하거나, 알림을 케이스와 연관시키거나, 조사 노트를 추가하거나, 상태나 심각도를 업데이트하거나, 트리아지 출력을 관리할 때 사용합니다. | 0.2.0 | elastic | | [kibana-context-engine](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-context-engine/SKILL.md) | Elastic Context Engine AI 인덱스와 그 인덱스가 저장하는 Knowledge Indicators(KI)를 쿼리합니다. AI 인덱스 / KI / Context Engine 지식 인덱스에서 검색, 탐색, 개수 세기 또는 질문에 답하라는 요청을 받았을 때, 그리고 이를 쿼리하는 ES\|QL을 작성할 때 사용합니다. | 0.2.1 | elastic | | [kibana-dashboards](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-dashboards/SKILL.md) | Kibana 대시보드와 Lens 시각화를 생성하고 관리합니다. 대시보드와 시각화를 선언적으로 정의하고, 버전 관리하고, 배포를 자동화하거나, 레이아웃, 섹션, 컨트롤, 차트 디자인을 개선해야 할 때 사용합니다. | 0.4.0 | elastic | | [kibana-workflows](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-workflows/SKILL.md) | Elastic Workflow YAML 정의를 작성, 검증, 테스트, 실행, 검사합니다. 사용자가 자연어를 Kibana 워크플로로 전환하거나, 워크플로 YAML을 수정하거나, 트리거나 단계를 이해하거나, 실제 Kibana에 대해 빠른 테스트 루프를 실행하고자 할 때 사용합니다. | 0.5.0 | elastic | </details> <details> <summary>Observability (6)</summary> | 스킬 | 설명 | 버전 | 작성자 | | ----- | ----------- | ------- | ------ | | [observability-csp-investigation](https://github.com/elastic/agent-skills/blob/main/skills/observability/csp-investigation/SKILL.md) | 클라우드 제공자(CSP) 서비스 문제를 조사합니다 — 현재는 AWS(추론은 모든 AWS 서비스에 적용되며, 스키마와 장애 시그니처는 RDS, Lambda, SQS, ALB, EC2에 대해 가장 상세함), 향후에는 GCP와 Azure — Elastic의 OTel 스키마 클라우드 메트릭을 사용합니다. 알림으로 트리거되었든 임시적이든, 클라우드 리소스 문제를 진단할 때 사용합니다: 데이터베이스 연결/CPU/메모리 압박, 함수 오류율 및 스로틀링, 큐 백로그 및 컨슈머 지연, 로드 밸런서 5xx, 인스턴스 포화. 조사 중인 리소스를 자체 기준선과 상관시키고, 장애 모드를 분류하며, 동시에 발생하지만 무관한 조건을 배제합니다. | 0.2.0 | elastic | | [observability-k8s-investigation](https://github.com/elastic/agent-skills/blob/main/skills/observability/k8s-investigation/SKILL.md) | OTel 텔레메트리(EDOT)를 사용하여 Kubernetes 워크로드, 노드, 컨트롤 플레인 문제를 조사합니다. 파드 장애(CrashLoopBackOff, OOMKilled, Error), 노드 압박, 리소스 고갈, 이미지 풀 실패, 어드미션 거부, 오토스케일링 이상을 진단하거나 K8s 상태를 애플리케이션 신호와 상관시킬 때 사용합니다. OTel 수집 경로 전용 — 레거시 ECS Kubernetes 통합 형태는 범위 밖입니다. | 0.5.1 | elastic | | [observability-llm-obs](https://github.com/elastic/agent-skills/blob/main/skills/observability/llm-obs/SKILL.md) | 이미 Elastic에 수집된 데이터로부터 LLM 및 에이전틱 애플리케이션 동작에 관한 질문에 답합니다: 지연 시간 및 오류율, 토큰 및 비용 활용, 응답 품질 및 가드레일 이벤트, 에이전틱 호출 체인 오케스트레이션. 사용자가 LLM 모니터링, GenAI 관측성, 토큰 지출 또는 AI 비용, 모델 지연 시간, 프롬프트 또는 가드레일 실패, 또는 에이전트의 도구 호출 체인이 어떻게 실행되었는지에 대해 질문할 때 사용합니다. | 0.3.1 | elastic | | [observability-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/observability/onboarding/SKILL.md) | Elastic Distribution of OpenTelemetry(EDOT)를 사용하여 애플리케이션을 Elastic Observability에 온보딩합니다: 언어와 런타임에 따라 라우팅하고, 클래식 Elastic APM 에이전트를 감지하고 교체하며, 필요한 OTLP 구성을 적용한 다음, ES\|QL로 트레이스, 메트릭, 로그가 예상 서비스 이름 아래에 실제로 도착하는지 검증합니다. 서비스에 관측성을 추가할 때, 클래식 Elastic APM 에이전트에서 마이그레이션할 때, 또는 계측된 서비스가 Elastic에 나타나지 않는 이유를 디버깅할 때 사용합니다. | 0.3.0 | elastic | | [observability-service-reliability](https://github.com/elastic/agent-skills/blob/main/skills/observability/service-reliability/SKILL.md) | Elastic Observability에서 서비스 신뢰성 목표를 설계하고 운영합니다: SLI 유형과 방어 가능한 목표를 선택하고, 시간 창과 예산 책정 방법을 고르며, Kibana API를 통해 SLO를 생성 및 유지하고, 번 레이트 알림 규칙을 연결하며, SLO가 잘못된 도구이고 임계값 규칙, 이상 탐지 작업 또는 신서틱 모니터가 적합한 경우를 판단합니다. SLO와 오류 예산을 정의하거나 검토할 때, 번 레이트 알림을 조정할 때, 알림 노이즈를 줄일 때, 또는 사용자 대면 엔드포인트에 대한 가용성 모니터링을 설정할 때 사용합니다. | 0.4.1 | elastic | | [observability-sre-triage](https://github.com/elastic/agent-skills/blob/main/skills/observability/sre-triage/SKILL.md) | 성능이 저하되었거나 의심스러운 서비스를 처음부터 끝까지 트리아지합니다: SLO 상태와 번 레이트를 읽고, 활성 알림 규칙과 ML 이상을 확인하며, 처리량, 지연 시간, 오류율을 측정하고, 의존성 상태와 인프라 포화를 평가하며, 로그를 좁혀 원인을 설명하는 실패로 좁힙니다. 누군가 서비스가 정상인지, 왜 느리거나 오류가 나는지, 로그에 무엇이 있는지, 또는 실패하는 요청을 구분하는 속성이 무엇인지 물을 때 사용합니다. 또한 누군가 처리량, 지연 시간 백분위수, 오류율, 의존성 상태, 로그 볼륨 등 해당 신호 중 하나에 대한 쿼리를 APM/OTel 트레이스, 메트릭 또는 로그에 대해 요청할 때도 사용합니다. | 0.5.2 | elastic | </details> <details> <summary>보안 (6)</summary> | 스킬 | 설명 | 버전 | 작성자 | | ----- | ----------- | ------- | ------ | | [security-alert-analysis](https://github.com/elastic/agent-skills/blob/main/skills/security/alert-analysis/SKILL.md) | 특정 Elastic Security 탐지 경보를 조사합니다: 컨텍스트를 수집하고, 엔티티 위험을 평가하고, 위협을 분류하고, 조사 결과를 문서화하며, 선택적으로 확인(acknowledge)합니다. 단일 알려진 경보를 트리아지하거나, SOC 조사를 수행하거나, security-alert-triage 스킬이 조사할 그룹을 식별한 후 후속 조치를 할 때 사용합니다. | 0.1.0 | elastic | | [security-alert-triage](https://github.com/elastic/agent-skills/blob/main/skills/security/alert-triage/SKILL.md) | 가중 위험 — 기본 위험 점수, MITRE 전술 부스트, 엔티티 위험, 자산 중요도 — 을 기준으로 Elastic Security 경보 큐의 우선순위를 정하고 순위를 매긴 다음, 경보를 엔티티 그룹으로 클러스터링합니다. 분석가가 무엇에 집중해야 하는지, 어떤 경보가 가장 긴급한지 묻거나, 더 깊은 조사를 시작하기 전에 큐 전반에 걸친 순위가 매겨진 시작점을 원할 때 사용합니다. | 0.2.0 | elastic | | [security-case-management](https://github.com/elastic/agent-skills/blob/main/skills/security/case-management/SKILL.md) | Kibana Cases API를 통해 SOC 케이스를 생성, 검색, 업데이트, 관리합니다. 인시던트를 추적하거나, 경보를 케이스에 연결하거나, 조사 노트를 추가하거나, 트리아지 출력을 관리할 때 사용합니다. | 0.1.0 | elastic | | [security-detection-rule-management](https://github.com/elastic/agent-skills/blob/main/skills/security/detection-rule-management/SKILL.md) | Elastic Security 탐지 규칙(SIEM 및 Endpoint)을 생성, 튜닝, 관리합니다. 오탐, 예외, 새로운 커버리지, 노이즈가 많은 규칙 또는 Kibana API를 통한 규칙 관리에 사용합니다. | 0.1.0 | elastic | | [security-generate-security-sample-data](https://github.com/elastic/agent-skills/blob/main/skills/security/generate-security-sample-data/SKILL.md) | Elastic Security용 샘플 보안 이벤트, 공격 시나리오, 합성 경보를 생성합니다. 데모를 하거나, 대시보드를 채우거나, 탐지 규칙을 테스트하거나, POC를 설정할 때 사용합니다. | 0.1.0 | elastic | | [security-ml-integrations](https://github.com/elastic/agent-skills/blob/main/skills/security/ml-integrations/SKILL.md) | Elastic 보안 ML 통합 패키지(beaconing, ded, dga, lmd, pad, problemchild)를 설치하고 관리합니다. 전체 수명 주기를 처리합니다: 사전 점검, Fleet 패키지 설치, 컴포넌트 템플릿, 수집 파이프라인, 트랜스폼, 데이터 뷰, ML 이상 탐지 작업, 탐지 규칙. 사용자가 보안 ML 통합 패키지를 설치, 설정, 상태 확인 또는 문제 해결하도록 요청할 때 사용합니다. | 0.1.0 | elastic | </details> <!-- END-SKILL-TABLE --> ## 보안 고려 사항 AI 코딩 에이전트는 실제 자격 증명, 실제 셸 접근 권한, 그리고 흔히 이를 실행하는 사용자의 전체 권한으로 작동합니다. 이러한 에이전트가 보안 워크플로를 향할 때는 위험 부담이 더 커집니다. 따라서 시작하기 전에 위험에 대해 솔직하게 논의할 필요가 있습니다. - **직접 위협 모델링을 수행하세요.** 에이전트가 어떤 데이터에 접근할 수 있는지, 어떤 작업을 수행할 수 있는지, 예기치 않게 동작할 경우 어떤 일이 발생하는지 평가하세요. [AI 시스템을 안전하게 배포하기 위한 CISA의 공동 지침](https://www.cisa.gov/news-events/alerts/2024/04/15/joint-guidance-deploying-ai-systems-securely)은 좋은 출발점입니다. - **에이전트를 통해 어떤 데이터가 흐르는지 인지하세요.** 보안 데이터에는 PII, 명령줄에 포함된 자격 증명 및 기타 규제 대상 데이터가 포함될 수 있습니다. 에이전트가 알림이나 프로세스 이벤트를 쿼리하면 해당 콘텐츠가 모델의 컨텍스트에 들어가고 타사 API로 전송될 수 있습니다. 정보 보안 및 컴플라이언스 팀을 초기에 참여시키세요. - **이 에이전트들은 공격자가 제어하는 입력을 처리합니다.** 알림, 이벤트 필드, 파일 콘텐츠에는 공격자가 조작한 문자열이 정기적으로 포함됩니다. 여기서 프롬프트 인젝션은 이론적인 것이 아니라 운영 환경의 본질적인 속성입니다. [Brainworm](https://www.originhq.com/blog/brainworm)과 같은 연구는 에이전트 컨텍스트 파일만으로도 프롬프트웨어의 지속성 메커니즘 역할을 할 수 있음을 보여줍니다. - **권한 범위를 엄격하게 제한하세요.** API 키에는 필요한 최소 권한만 부여하세요. 광범위한 응답 권한은 특히 위험합니다. 동작을 검증할 때까지 읽기 전용 액세스가 좋은 기본값입니다. - **에이전트 도구 액세스 및 네트워크 도달 범위를 제한하세요.** 대부분의 AI 코딩 에이전트는 셸 실행, 파일 시스템 쓰기, 인터넷 액세스 등 광범위한 기본값으로 제공됩니다. 사용 가능한 도구 표면을 줄이면 침해되었거나 잘못된 방향으로 향한 에이전트가 할 수 있는 일이 제한됩니다. - **비프로덕션 환경에서 시작하세요.** 스킬을 실제 보안 데이터를 다루는 어떤 것에도 연결하기 전에 Serverless 체험 프로젝트, 개발 클러스터 또는 격리된 Kibana 공간을 사용하여 평가하세요. 이 스킬들은 여러분이 수행하는 작업을 감사할 수 있도록 오픈 소스로 제공됩니다. 실행하기 전에 읽어 보시기를 권장합니다. ## 시작하기 Claude Code 네이티브 플러그인 시스템, `npx`와 함께 사용하는 `skills` CLI, 또는 이 저장소를 복제하고 번들 설치 스크립트를 실행하여 Elastic 스킬을 설치할 수 있습니다. `npx` 방식은 환경에 `npx`가 포함된 `Node.js`가 필요합니다. > [!TIP] > **모든 스킬을 설치하지 마세요.** 설치된 각 스킬은 에이전트가 모든 요청에서 평가하는 라우팅 컨텍스트를 추가합니다. **cloud** 및 **elasticsearch** 인증 스킬을 설치하세요 — 대부분의 다른 스킬이 이들에 의존합니다 — 그런 다음 워크플로에 관련된 스킬만 추가하세요. 설치된 세트를 집중적으로 유지하면 컨텍스트 비대화를 피하고 에이전트가 올바른 스킬로 안정적으로 라우팅되도록 돕습니다. ### Claude Code 플러그인 (Claude Code 사용자에게 권장) Claude Code에는 스킬을 직접 관리하는 네이티브 플러그인 시스템이 있습니다. 먼저 이 저장소를 마켓플레이스 소스로 추가하세요: ```sh claude plugin marketplace add https://github.com/elastic/agent-skills ``` 추가한 후에는 이름으로 개별 플러그인을 설치합니다: ```sh claude plugin install elastic-elasticsearch@elastic-agent-skills claude plugin install elastic-kibana@elastic-agent-skills claude plugin install elastic-observability@elastic-agent-skills claude plugin install elastic-security@elastic-agent-skills claude plugin install elastic-cloud@elastic-agent-skills ``` > [!NOTE] > 설치 후 `/reload-plugins`를 실행해도 스킬이 즉시 표시되지 않을 수 있습니다. 이는 알려진 Claude Code 문제입니다 — 새로 설치된 플러그인을 인식하려면 Claude Code 세션을 재시작하세요. 또는 모든 Claude Code 세션 내에서 대화형 플러그인 브라우저를 사용하세요: ``` /plugins ``` 이 메뉴는 구성된 모든 마켓플레이스에서 사용 가능한 플러그인을 탐색하고, 설치할 항목을 선택하며, 이미 설치된 항목을 관리할 수 있도록 열어줍니다. ### GitHub Copilot CLI GitHub Copilot CLI에는 기본 플러그인 시스템이 있습니다. 이 저장소를 마켓플레이스 소스로 추가하세요: ```sh copilot plugin marketplace add elastic/agent-skills ``` 추가한 후에는 이름으로 개별 플러그인을 설치합니다: ```sh copilot plugin install elasticsearch@elastic-agent-skills copilot plugin install kibana@elastic-agent-skills copilot plugin install observability@elastic-agent-skills copilot plugin install security@elastic-agent-skills copilot plugin install cloud@elastic-agent-skills ``` Copilot 세션 내에서 사용 가능한 플러그인을 대화형으로 탐색할 수도 있습니다: ``` /plugin list ``` ### npx (권장) 스킬을 설치하는 가장 빠른 방법은 [`skills`](https://github.com/vercel-labs/skills) CLI를 사용하는 것입니다. 이 저장소를 복제할 필요 없이 다음을 실행하기만 하면 됩니다: ```sh npx skills add elastic/agent-skills ``` 스킬과 [대상 에이전트](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)를 선택할 수 있는 대화형 프롬프트가 실행됩니다. CLI는 각 스킬 폴더를 에이전트가 인식할 수 있는 올바른 위치로 복사합니다. 이름으로 특정 스킬을 설치합니다: ```sh npx skills add elastic/agent-skills --skill elasticsearch-esql ``` 또는 `@` 축약형을 사용하여 `repo@skill`로 스킬을 직접 지정할 수 있습니다(`--skill`과 동일): ```sh npx skills add elastic/agent-skills@elasticsearch-esql ``` 특정 에이전트에 설치([지원되는 에이전트](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents) 참조): ```sh npx skills add elastic/agent-skills -a cursor -a claude-code ``` 사용 가능한 스킬을 설치하지 않고 나열하기: ```sh npx skills add elastic/agent-skills --list ``` 모든 에이전트에 모든 스킬 설치(비대화형): ```sh npx skills add elastic/agent-skills --all ``` | 플래그 | 설명 | | ----------------- | ------------------------------------------------- | | `-a, --agent` | 특정 에이전트 대상 지정 ([지원 에이전트](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents) 참조) | | `-s, --skill` | 이름으로 특정 스킬 설치 | | `-g, --global` | 프로젝트 디렉터리 대신 사용자 홈에 설치 | | `-y, --yes` | 확인 프롬프트 건너뛰기 | | `--all` | 프롬프트 없이 모든 에이전트에 모든 스킬 설치 | | `--list` | 설치 없이 사용 가능한 스킬 목록 표시 | ### 로컬 클론 로컬 체크아웃에서 작업하는 것을 선호하거나 환경에 Node.js / npx가 없는 경우, 저장소를 클론하고 번들로 제공되는 bash 설치 프로그램을 사용하세요: ```sh git clone https://github.com/elastic/agent-skills.git cd agent-skills ./scripts/install-skills.sh add -a <agent> ``` 이 스크립트는 bash 3.2+ 및 표준 Unix 유틸리티(`awk`, `find`, `cp`, `rm`, `mkdir`)를 필요로 합니다. | 플래그 | 설명 | | ----------------- | ------------------------------------- | | `-a, --agent` | 대상 에이전트 (반복 가능) | | `-s, --skill` | 이름으로 특정 스킬 설치 | | `-f, --force` | 이미 설치된 스킬 덮어쓰기 | | `-y, --yes` | 확인 프롬프트 건너뛰기 | 사용 가능한 모든 스킬 나열: ```sh ./scripts/install-skills.sh list ``` ### 지원되는 에이전트 | 에이전트 | 설치 디렉터리 | | --------------- | ------------------------- | | claude-code | `.claude/skills` | | cursor | `.agents/skills` | | codex | `.agents/skills` | | opencode | `.agents/skills` | | pi | `.pi/agent/skills` | | windsurf | `.windsurf/skills` | | roo | `.roo/skills` | | cline | `.agents/skills` | | github-copilot | `.agents/skills` | | gemini-cli | `.agents/skills` | ## 스킬 업데이트 업데이트 절차는 스킬이 어떻게 설치되었는지에 따라 달라집니다. ### Claude Code 플러그인 설치된 모든 플러그인을 최신 버전으로 업데이트합니다: ```sh claude plugin update ``` 특정 플러그인 업데이트: ```sh claude plugin update elastic-elasticsearch ``` 플러그인을 자동으로 최신 상태로 유지하려면 Claude Code 내에서 `/plugins`를 사용하여 자동 업데이트를 활성화하세요. 자동 업데이트가 켜져 있으면 Claude Code는 시작 시 새 플러그인 버전을 확인하고 백그라운드에서 업데이트합니다. ### GitHub Copilot CLI 설치된 모든 플러그인을 최신 버전으로 업데이트합니다: ```sh copilot plugin update ``` 특정 플러그인 업데이트: ```sh copilot plugin update elasticsearch ``` ### npx 설치된 스킬 중 업스트림에서 변경된 것이 있는지 확인합니다: ```sh npx skills check ``` 설치된 모든 스킬의 최신 버전을 가져옵니다: ```sh npx skills update ``` CLI는 각 스킬의 소스 저장소와 콘텐츠 해시를 잠금 파일에 추적합니다. `check`는 로컬 해시를 GitHub와 비교하고, `update`는 변경된 항목을 다시 다운로드합니다. > **팁:** 기본 npx 설치 방식은 심볼릭 링크를 사용하므로 모든 에이전트가 하나의 표준 복사본을 가리킵니다. 한 번 업데이트하면 모든 에이전트가 동시에 갱신됩니다. ### 로컬 클론 기존 스킬을 덮어쓰려면 `--force` 옵션으로 설치 프로그램을 다시 실행하세요: ```sh git pull ./scripts/install-skills.sh add -a <agent> --force ``` `--force` 없이 스크립트는 이미 설치된 스킬을 건너뜁니다. ## 스킬 형식 모든 스킬 폴더에는 YAML 프런트매터와 마크다운 지침이 포함된 `SKILL.md`가 있습니다: ```yaml --- name: elasticsearch-my-skill description: > What the skill does AND when an agent should activate it. metadata: version: 0.1.0 visibility: public --- # My Skill [Instructions that the agent follows when this skill is active] ``` --- [Read more](https://github.com/elastic/agent-skills)