agent-skills v0.4.0
공식 Elastic 스킬
Elastic Agent Skills
Elastic Agent Skills — Elastic를 만든 사람들이 직접 개발한 — 는 네이티브 플랫폼 전문 지식을 여러분의 AI 코딩 에이전트에 직접 제공합니다. 이는 공식 Agent Skills 라이브러리로, Cursor, GitHub Copilot, Windsurf, Gemini CLI 등과 같은 에이전트형 IDE와 호환됩니다. 스킬은 Agent Skills 오픈 표준을 따릅니다.
[!NOTE] 기술 프리뷰
이 스킬들은 초기 릴리스 단계에 있으며 활발히 개발 중입니다. 스킬이 견고한 평가와 함께 정립되고 모델 환경이 진화함에 따라 변경될 수 있습니다. 업데이트를 자주 확인하세요.
소개
이 저장소에는 모든 AI 에이전트가 Elasticsearch, Kibana, Elastic Observability, Elastic Security를 올바르게 다루는 방법을 가르치는 지침, 컨텍스트, 도구의 패키지인 엄선된 스킬들이 포함되어 있습니다. 이미 사용 중인 에이전트 런타임에 이들을 추가하면, 여러분의 어시스턴트는 구식 패턴 사용을 멈추고 올바르게 작동하기 시작합니다.
스킬이란 무엇인가요?
스킬은 AI 에이전트가 특정 작업을 반복 가능한 방식으로 완수할 수 있도록 지식과 도구를 제공하는 자체 완결형 패키지입니다. 각 스킬은 메타데이터와 에이전트가 따르는 지침이 담긴 SKILL.md 파일과 함께 자체 폴더에 위치합니다.
Agent Skills 표준에 대한 더 많은 배경 정보는 agentskills.io를 참고하세요.
범위
이 저장소의 스킬들은 다음에 중점을 둡니다:
- Elasticsearch API와의 상호작용 (검색, 인덱싱, 클러스터 관리)
- 알림, 커넥터 등과 같은 Kibana 콘텐츠의 구축 및 관리
- Elastic Observability, Elastic Security, Agent Builder를 위한 패턴
사용 가능한 스킬
Cloud (2)
| Skill | Description | Version | Author |
|---|---|---|---|
| cloud-onboarding | Elastic Cloud 조직을 온보딩합니다: elastic CLI의 Cloud 컨텍스트와 API 키를 구성하고, 기본 리전을 설정한 다음, 사용자를 초대하고, 사전 정의되거나 사용자 정의된 Serverless 프로젝트 역할을 할당하며, Cloud API 키를 생성하거나 폐기합니다. Cloud 인증을 설정할 때 또는 조직과 그 프로젝트에 대한 사용자 접근을 부여, 수정, 감사할 때 사용합니다. | 0.3.0 | elastic |
| cloud-provisioning | Elastic Cloud 인프라를 프로비저닝하고 운영합니다: Serverless 프로젝트(Elasticsearch, Observability, Security)를 생성, 연결, 업데이트, 삭제하고, 트래픽 필터(IP 및 AWS PrivateLink 네트워크 보안)를 관리하며, Elastic Cloud Hosted 배포의 수명 주기를 관리합니다. Serverless 프로젝트나 호스팅 배포를 생성하거나 2일차 운영을 수행할 때, 또는 이들의 네트워크 접근을 제한할 때 사용합니다. | 0.3.0 | elastic |
Elasticsearch (10)
| Skill | Description | Version | Author |
|---|---|---|---|
| elasticsearch-anomaly-detection | API를 통해 Elastic ML 이상 탐지 작업을 생성하고 관리합니다. 인덱스나 데이터 스트림에 작업을 설정하거나, 작업과 데이터피드를 구성하거나, 이들을 열거나 시작하거나 중지할 때 사용합니다. | 1.1.0 | elastic |
| elasticsearch-anomaly-detection-explainer | Elasticsearch ML 이상 탐지 점수, 모델 동작, 결과 해석을 설명합니다. 사용자가 점수가 왜 높거나 낮은지, 모델이 어떻게 학습하는지, 숫자가 무엇을 의미하는지, 또는 예상치 못한 이상 점수를 어떻게 문제 해결하는지 물을 때 사용합니다. | 0.3.0 | elastic |
| elasticsearch-cluster-health | 그린 상태가 아닌 Elasticsearch 클러스터를 진단하고 가장 가능성 높은 단일 원인과 해결책을 제시합니다. 운영자가 옐로우 또는 레드 상태, 할당되지 않은 샤드, 할당 실패를 보고하거나 더 깊은 조사 전에 읽기 전용 트리아지를 원할 때 사용합니다. 레플리카 대 프라이머리 영향, 할당 결정자 분류, 데이터 손실 인식을 가르칩니다. | 0.1.0 | elastic |
| elasticsearch-esql | ES|QL(Elasticsearch Query Language) 쿼리를 실행합니다. 사용자가 Elasticsearch 데이터를 쿼리하거나, 로그를 분석하거나, 메트릭을 집계하거나, 데이터를 탐색하거나, ES|QL 결과로 차트와 대시보드를 만들고자 할 때 사용합니다. | 0.7.0 | elastic |
| elasticsearch-index-design | 명시된 접근 패턴에 맞게 Elasticsearch 인덱스 매핑을 설계하고 검토합니다: 올바른 필드 타입, text+keyword 멀티 필드, doc_values 튜닝, 매핑 폭발 방지, 명시적 샤드 설정. 새 인덱스를 생성하거나, 저장 또는 쿼리 성능을 위해 매핑을 검토하거나, 잘못된 필드 타입을 수정하거나, 사용자가 필드에 대한 검색, 필터, 정렬, 집계에 어떤 타입을 사용할지 물을 때 사용합니다. | 0.1.0 | elastic |
| elasticsearch-ingest | 필드 타입이 중요할 때 bulk API와 명시적 매핑을 사용하여 CSV 및 JSON 파일을 Elasticsearch 인덱스에 로드합니다. 로컬 파일을 일괄 가져오거나, CSV 행이나 JSON 배열을 NDJSON bulk 형식으로 변환하거나, 수집 후 문서 수와 매핑을 검증할 때 사용합니다 — Logstash 파이프라인, Beats, 사용자 정의 스크립트, 인덱스 간 재색인에는 사용하지 않습니다. | 0.1.0 | elastic |
| elasticsearch-onboarding | Elasticsearch를 처음 접하는 개발자가 제로에서 작동하는 검색 경험에 도달하도록 돕습니다. 의도를 이해하고, 데이터를 매핑하고, 모범 사례가 내장된 검색 경험을 구축하도록 안내합니다. 사용자가 검색 관련 기능을 구축하려는 의도를 보이거나, 자신의 사용 사례에 대한 Elasticsearch 관련 개념을 묻거나, Elasticsearch 시작에 도움이 필요하다고 표현할 때 사용합니다. | 0.1.0 | elastic |
| elasticsearch-query-optimization | 느린 Elasticsearch Query DSL 검색을 진단하고 측정된 수정을 제안합니다. 검색이 느리거나, 프로파일 출력이 비용이 큰 절을 보여주거나, 정확 일치 필터가 스코어링 컨텍스트에 있거나, 선행 와일드카드가 지연 시간을 지배할 때 사용합니다. 모든 권장 사항을 검색 프로파일링에 근거하세요 — 비스코어링 절을 필터 컨텍스트로 이동하고, 선행 와일드카드를 제거하고, 개선을 확인하기 위해 다시 프로파일링하세요. | 0.1.0 | elastic |
| elasticsearch-reindex | 성능을 위한 Elasticsearch 재색인을 안내합니다: 로컬 및 원격, 슬라이싱, 스로틀링, task API. 인덱스를 복사하거나 마이그레이션하거나, 매핑을 변경하거나, 재색인 중 변환할 때 사용합니다. | 0.2.0 | elastic |
| elasticsearch-search-relevance | 콘텐츠 및 카탈로그 인덱스에 대한 Elasticsearch 검색 관련성을 개선합니다: 쿼리 규칙으로 결과를 고정하거나 승격하고(올바른 규칙 타입, 기준, 규칙-쿼리 연결), 인덱스 매핑에 근거한 multi_match, 필드 부스트, 분석으로 자연 순위를 튜닝합니다. 검색 결과의 순위가 좋지 않거나, 특정 문서가 쿼리에 대해 먼저 나타나야 하거나, 사용자가 전문 검색 매칭을 튜닝하도록 요청할 때 사용합니다 — ES|QL 분석, 인덱스 수집, 클러스터 상태에는 사용하지 않습니다. | 0.1.0 | elastic |
Kibana (5)
| Skill | Description | Version | Author |
|---|---|---|---|
| kibana-agent-builder | Kibana Agent Builder 에이전트와 사용자 정의 도구를 생성하고 관리합니다. Agent Builder에서 에이전트나 도구를 생성, 업데이트, 삭제, 테스트, 검사하도록 요청받거나, 사용자가 이미 존재하는 에이전트나 도구를 이해하고자 할 때 사용합니다. | 0.3.0 | elastic |
| kibana-alerting-rules | Kibana 알림 규칙을 생성하고 관리합니다. 규칙 수명 주기(활성화, 비활성화, 음소거, 스누즈)를 생성, 업데이트, 관리하거나, 메트릭 임계값 규칙 타입과 파라미터를 선택하거나, 태그 필터로 읽기 전용 찾기/목록을 수행할 때 사용합니다. | 0.3.0 | elastic |
| kibana-anomaly-detection | Elastic ML 이상 탐지 — 조사/RCA, 점수 설명, 작업 수명 주기 문제 해결, 작업 운영. "무엇이 고장 났나?"/"어떤 엔티티인가?"/RCA, "점수가 왜 높거나 낮은가?"/재정규화, "데이터피드가 멈췄다"/"메모리 제한"/hard_limit에 답하거나 ML 이상 탐지 작업을 구성할 때 사용합니다. .ml-anomalies-*에서 결과를 읽고 ML REST API에서 작업 상태를 읽습니다. | 0.3.0 | elastic |
| kibana-dashboards | Kibana 대시보드와 Lens 시각화를 생성하고 관리합니다. 대시보드와 시각화를 선언적으로 정의하거나, 버전 관리하거나, 배포를 자동화해야 할 때 사용합니다. | 0.3.0 | elastic |
| kibana-workflows | Elastic Workflow YAML 정의를 작성, 검증, 테스트, 실행, 검사합니다. 사용자가 자연어를 Kibana 워크플로로 전환하거나, 워크플로 YAML을 수정하거나, 트리거나 단계를 이해하거나, 실제 Kibana에 대해 빠른 테스트 루프를 실행하고자 할 때 사용합니다. | 0.5.0 | elastic |
Observability (5)
| Skill | Description | Version | Author |
|---|---|---|---|
| observability-k8s-investigation | OTel 텔레메트리(EDOT)를 사용하여 Kubernetes 워크로드, 노드, 컨트롤 플레인 문제를 조사합니다. 파드 실패(CrashLoopBackOff, OOMKilled, Error), 노드 압박, 리소스 고갈, 이미지 풀 실패, 어드미션 거부, 오토스케일링 이상을 진단하거나 K8s 상태를 애플리케이션 신호와 연관시킬 때 사용합니다. OTel 수집 경로 전용 — 레거시 ECS Kubernetes 통합 형태는 범위 밖입니다. | 0.5.1 | elastic |
| observability-llm-obs | 이미 Elastic에 수집된 데이터로부터 LLM 및 에이전트형 애플리케이션 동작에 대한 질문에 답합니다: 지연 시간과 오류율, 토큰 및 비용 활용, 응답 품질과 가드레일 이벤트, 에이전트형 호출 체인 오케스트레이션. 사용자가 LLM 모니터링, GenAI 관측성, 토큰 지출 또는 AI 비용, 모델 지연 시간, 프롬프트 또는 가드레일 실패, 또는 에이전트의 도구 호출 체인이 어떻게 실행되었는지 묻을 때 사용합니다. | 0.3.1 | elastic |
| observability-onboarding | Elastic Distribution of OpenTelemetry(EDOT)로 애플리케이션을 Elastic Observability에 온보딩합니다: 언어와 런타임에 따라 라우팅하고, 클래식 Elastic APM 에이전트를 감지하고 교체하며, 필요한 OTLP 구성을 적용한 다음, 트레이스, 메트릭, 로그가 예상 서비스 이름 아래에 실제로 도착하는지 ES|QL로 검증합니다. 서비스에 관측성을 추가하거나, 클래식 Elastic APM 에이전트에서 마이그레이션하거나, 계측된 서비스가 Elastic에 나타나지 않는 이유를 디버깅할 때 사용합니다. | 0.3.0 | elastic |
| observability-service-reliability | Elastic Observability에서 서비스 신뢰성 목표를 설계하고 운영합니다: SLI 유형과 방어 가능한 목표를 선택하고, 시간 창과 예산 책정 방법을 고르고, Kibana API를 통해 SLO를 생성하고 유지하며, 번 레이트 알림 규칙을 연결하고, SLO가 잘못된 도구이며 임계값 규칙, 이상 작업, 신서틱 모니터가 적합한 시점을 결정합니다. SLO와 오류 예산을 정의하거나 검토하거나, 번 레이트 알림을 튜닝하거나, 알림 노이즈를 줄이거나, 사용자 대면 엔드포인트에 대한 가용성 모니터링을 설정할 때 사용합니다. | 0.4.1 | elastic |
| observability-sre-triage | 성능이 저하되었거나 의심스러운 서비스를 처음부터 끝까지 트리아지합니다: SLO 상태와 번 레이트를 읽고, 활성 알림 규칙과 ML 이상을 확인하고, 처리량, 지연 시간, 오류율을 측정하고, 의존성 상태와 인프라 포화를 평가하고, 로그를 필터링하여 이를 설명하는 실패로 좁힙니다. 누군가 서비스가 건강한지, 왜 느리거나 오류가 나는지, 로그에 무엇이 있는지, 또는 실패하는 요청을 구별하는 속성이 무엇인지 물을 때 사용합니다. 또한 누군가 그러한 신호들 — 처리량, 지연 시간 백분위수, 오류율, 의존성 상태, 로그 볼륨 — 중 어느 것에 대한 쿼리를 APM/OTel 트레이스, 메트릭, 로그에 걸쳐 요청할 때 사용합니다. | 0.5.1 | elastic |
Security (4)
| Skill | Description | Version | Author |
|---|---|---|---|
| security-alert-triage | Elastic Security 알림을 트리아지합니다 — 컨텍스트를 수집하고, 위협을 분류하고, 케이스를 생성하고, 확인합니다. 알림을 트리아지하거나, SOC 분석을 수행하거나, 탐지를 조사할 때 사용합니다. | 0.1.0 | elastic |
| security-case-management | Kibana Cases API를 통해 SOC 케이스를 생성, 검색, 업데이트, 관리합니다. 인시던트를 추적하거나, 알림을 케이스에 연결하거나, 조사 노트를 추가하거나, 트리아지 출력을 관리할 때 사용합니다. | 0.1.0 | elastic |
| security-detection-rule-management | Elastic Security 탐지 규칙(SIEM 및 Endpoint)을 생성, 튜닝, 관리합니다. 오탐, 예외, 새로운 커버리지, 노이즈가 많은 규칙, 또는 Kibana API를 통한 규칙 관리에 사용합니다. | 0.1.0 | elastic |
| security-generate-security-sample-data | Elastic Security를 위한 샘플 보안 이벤트, 공격 시나리오, 합성 알림을 생성합니다. 데모하거나, 대시보드를 채우거나, 탐지 규칙을 테스트하거나, POC를 설정할 때 사용합니다. | 0.1.0 | elastic |
보안 고려 사항
AI 코딩 에이전트는 실제 자격 증명, 실제 셸 접근 권한, 그리고 종종 이를 실행하는 사용자의 전체 권한으로 작동합니다. 이러한 에이전트가 보안 워크플로를 향할 때 위험은 더 커집니다. 따라서 시작하기 전에 위험에 대한 솔직한 논의가 필요합니다.
- 자체 위협 모델링을 수행하세요. 에이전트가 접근할 수 있는 데이터, 수행할 수 있는 작업, 예기치 않게 동작할 경우 발생할 수 있는 일을 평가하세요. AI 시스템을 안전하게 배포하기 위한 CISA의 공동 지침은 좋은 출발점입니다.
- 에이전트를 통해 흐르는 데이터를 인식하세요. 보안 데이터에는 PII, 명령줄에 포함된 자격 증명, 기타 규제 대상 데이터가 포함될 수 있습니다. 에이전트가 알림이나 프로세스 이벤트를 쿼리할 때, 그 콘텐츠는 모델의 컨텍스트에 들어가며 제3자 API로 전송될 수 있습니다. 정보 보안 및 컴플라이언스 팀을 초기에 참여시키세요.
- 이 에이전트들은 공격자가 제어하는 입력을 처리합니다. 알림, 이벤트 필드, 파일 콘텐츠에는 정기적으로 공격자가 조작한 문자열이 포함됩니다. 프롬프트 인젝션은 여기서 이론적이지 않으며, 운영 환경의 본질적인 속성입니다. 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
This opens a menu to browse available plugins from all configured marketplaces, select what to install, and manage what is already installed.
### GitHub Copilot CLI
GitHub Copilot CLI has a native plugin system. Add this repository as a marketplace source:```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 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 | 특정 에이전트를 대상으로 지정 (참조: 지원되는 에이전트) |
-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
이 스크립트는 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 --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]
description 필드는 유일한 트리거 메커니즘으로, 에이전트 런타임이 이를 읽고 스킬을 언제 로드할지 결정합니다. 전체 형식 명세는 agentskills.io/specification을 참조하세요.
이슈
문제를 발견했거나 제안 사항이 있으신가요? 이슈를 열어주세요. 검토하겠습니다.
면책 조항
이 스킬들은 있는 그대로 제공됩니다. 중요한 작업에 의존하기 전에 항상 자신의 환경에서 스킬을 철저히 테스트하세요.