Elastic Agent Skills

Elastic Agent Skills — Elastic을 만든 사람들이 구축한 — AI 코딩 에이전트에 네이티브 플랫폼 전문 지식을 직접 제공합니다. 이는 Cursor, GitHub Copilot, Windsurf, Gemini CLI 등과 같은 에이전틱 IDE와 호환되는 공식 Agent Skills 라이브러리입니다. Skills는 Agent Skills 오픈 표준을 따릅니다.

[!NOTE] 기술 프리뷰

이 스킬은 초기 릴리스 단계이며 활발히 개발 중입니다. 스킬이 강력한 평가와 함께 체계화되고 모델 환경이 발전함에 따라 변경될 수 있습니다. 업데이트를 자주 확인하세요.

소개

이 저장소에는 Elasticsearch, Kibana, Elastic Observability 및 Elastic Security로 올바르게 작업하는 방법을 모든 AI 에이전트에 가르치는 지침, 컨텍스트 및 도구의 패키지인 선별된 스킬이 포함되어 있습니다. 이미 사용 중인 에이전트 런타임에 스킬을 넣으면 어시스턴트가 더 이상 구식 패턴을 사용하지 않고 올바르게 작업을 수행합니다.

스킬이란 무엇인가요?

스킬은 AI 에이전트가 특정 작업을 반복 가능한 방식으로 완료할 수 있는 지식과 도구를 제공하는 자체 포함 패키지입니다. 각 스킬은 SKILL.md 파일이 포함된 자체 폴더에 있으며, 여기에는 에이전트가 따르는 메타데이터와 지침이 포함되어 있습니다.

Agent Skills 표준에 대한 자세한 배경은 agentskills.io를 참조하세요.

범위

이 저장소의 스킬은 다음에 중점을 둡니다:

• Elasticsearch API와 상호작용 (검색, 인덱싱, 클러스터 관리)
• 알림, 커넥터 등과 같은 Kibana 콘텐츠 구축 및 관리
• Elastic Observability, Elastic Security 및 Agent Builder를 위한 패턴

사용 가능한 스킬

보안 고려 사항

AI 코딩 에이전트는 실제 자격 증명, 실제 셸 액세스, 그리고 종종 실행하는 사용자의 모든 권한으로 작동합니다. 이러한 에이전트가 보안 워크플로를 대상으로 할 때 위험은 더 커집니다. 시작하기 전에 위험에 대한 솔직한 논의가 필요합니다.

• 자체 위협 모델링을 수행하십시오. 에이전트가 액세스할 수 있는 데이터, 수행할 수 있는 작업, 예상치 못한 동작이 발생할 경우 어떤 일이 발생하는지 평가하십시오. AI 시스템을 안전하게 배포하기 위한 CISA의 공동 지침이 좋은 출발점입니다.
• 에이전트를 통해 어떤 데이터가 흐르는지 인지하십시오. 보안 데이터에는 PII, 명령줄에 포함된 자격 증명 및 기타 규제 대상 데이터가 포함될 수 있습니다. 에이전트가 알림 또는 프로세스 이벤트를 쿼리하면 해당 콘텐츠가 모델의 컨텍스트에 들어가 타사 API로 전송될 수 있습니다. 정보 보안 및 규정 준수 팀을 조기에 참여시키십시오.
• 이러한 에이전트는 공격자가 제어하는 입력을 처리합니다. 알림, 이벤트 필드 및 파일 내용에는 공격자가 조작한 문자열이 정기적으로 포함됩니다. 여기서 프롬프트 인젝션은 이론적이지 않습니다. 이는 운영 환경의 고유한 속성입니다. Brainworm과 같은 연구는 에이전트 컨텍스트 파일 단독으로 프롬프트웨어의 지속성 메커니즘 역할을 할 수 있음을 보여줍니다.
• 권한을 엄격하게 범위를 지정하십시오. API 키에 필요한 최소 권한을 부여하십시오. 광범위한 응답 권한은 특히 위험합니다. 읽기 전용 액세스는 동작을 확인할 때까지 좋은 기본값입니다.
• 에이전트 도구 액세스 및 네트워크 연결을 제한하십시오. 대부분의 AI 코딩 에이전트는 광범위한 기본값(셸 실행, 파일 시스템 쓰기, 인터넷 액세스)을 제공합니다. 사용 가능한 도구 표면을 줄이면 손상되거나 잘못된 방향으로 전환된 에이전트가 할 수 있는 작업이 제한됩니다.
• 비프로덕션 환경에서 시작하십시오. 라이브 보안 데이터를 전달하는 모든 항목에 연결하기 전에 스킬을 평가하기 위해 Serverless 평가판 프로젝트, 개발 클러스터 또는 격리된 Kibana 공간을 사용하십시오.

이러한 스킬은 오픈 소스로 제공되므로 정확히 수행하는 작업을 감사할 수 있습니다. 실행하기 전에 읽어볼 것을 권장합니다.

시작하기

Claude Code 네이티브 플러그인 시스템, npx를 사용한 skills CLI, 또는 이 저장소를 클론하고 번들 설치 스크립트를 실행하여 Elastic 스킬을 설치할 수 있습니다. npx 방법은 환경에 Node.js와 함께 npx를 사용할 수 있어야 합니다.

[!TIP] 모든 스킬을 설치하지 마십시오. 설치된 각 스킬은 에이전트가 모든 요청에서 평가하는 라우팅 컨텍스트를 추가합니다. cloud 및 elasticsearch 인증 스킬을 설치하십시오 — 대부분의 다른 스킬이 이에 의존합니다 — 그런 다음 워크플로에 관련된 스킬만 추가하십시오. 설치된 세트를 집중적으로 유지하면 컨텍스트 팽창을 피하고 에이전트가 올바른 스킬로 안정적으로 라우팅할 수 있습니다.

Claude Code 플러그인 (Claude Code 사용자에게 권장)

Claude Code에는 스킬을 직접 관리하는 네이티브 플러그인 시스템이 있습니다. 이 저장소를 마켓플레이스 소스로 추가하여 시작하십시오:```sh claude plugin marketplace add https://github.com/elastic/agent-skills

추가된 후에는 개별 플러그인을 이름으로 설치하십시오:```sh
claude plugin install elasticsearch@elastic-agent-skills
claude plugin install kibana@elastic-agent-skills
claude plugin install observability@elastic-agent-skills
claude plugin install security@elastic-agent-skills
claude plugin install 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를 설치하는 가장 빠른 방법은 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

로컬 클론

로컬 체크아웃에서 작업하거나 환경에 Node.js/npx가 없는 경우, 리포지토리를 클론하고 번들된 bash installer를 사용하세요:```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 플러그인

설치된 모든 플러그인을 최신 버전으로 업데이트합니다:```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]

The description 필드는 유일한 트리거 메커니즘입니다. 에이전트 런타임은 이를 읽어 스킬을 로드할 시점을 결정합니다. 전체 형식 사양은 agentskills.io/specification에서 확인하세요.

이슈

문제를 발견했거나 제안이 있으신가요? 이슈 열기를 통해 검토받으실 수 있습니다.

면책 조항

이 스킬들은 있는 그대로 제공됩니다. 중요한 작업에 의존하기 전에 항상 자신의 환경에서 철저히 테스트하세요.