Elastic Agent Skills

Elastic Agent Skills — Elastic을 만든 사람들이 구축한 — 네이티브 플랫폼 전문성을 AI 코딩 에이전트에 직접 제공합니다. 이는 Cursor, GitHub Copilot, Windsurf, Gemini CLI 등과 같은 에이전틱 IDE와 호환되는 공식 Agent Skills 라이브러리입니다. 스킬은 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 패턴

사용 가능한 스킬

보안 고려 사항

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 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 설치 프로그램을 사용하세요:```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 frontmatter와 마크다운 지침이 포함된 `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을 참조하세요.

Issues

문제를 발견했거나 제안이 있으신가요? 이슈 열기를 통해 검토를 요청하세요.

Disclaimer

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