AI 에이전트 스킬
원본 보기AI 에이전트 스킬
elastic/agent-skills 저장소는 AI 코딩 에이전트가 Elastic 스택을 다룰 수 있도록 돕는 공식 오픈소스 스킬 패키지를 제공합니다. Agent Skills 개방형 표준을 기반으로 하며, Claude Code, Cursor, GitHub Copilot 등의 에이전트에 Elastic 특화 작업을 더 정확하고 효율적으로 수행하는 데 필요한 전문 지식을 제공합니다.
스킬은 Elasticsearch API 사용, Kibana 대시보드 구축, Fleet 정책 구성, Observability 및 Elastic Security 워크플로 작업 등의 영역을 다룹니다.
AI 에이전트 스킬은 전문 지식으로 AI 에이전트의 기능을 확장하는 가볍고 개방적인 형식입니다. 각 스킬은 메타데이터와 지침이 담긴 SKILL.md 파일을 포함하는 독립적인 폴더입니다.
에이전트는 시작 시 name과 description 필드를 읽어 사용 가능한 스킬을 파악하고, 일치하는 작업이 감지되면 전체 지침을 필요할 때 로드합니다.
이 방식은 에이전트를 기본적으로 빠르게 유지하면서도 필요할 때 깊이 있는 절차적 지식에 접근할 수 있게 해줍니다.
표준에 대한 더 자세한 배경은 agentskills.io를 참조하세요.
elastic/agent-skills 저장소의 스킬은 Elastic 제품과 Elastic 스택에 초점을 맞춥니다:
- Elasticsearch API 사용(검색, 인덱싱, 클러스터 관리).
- Kibana 대시보드, 저장된 객체, 시각화의 구축 및 관리.
- Fleet 정책, Elastic Agent 통합, Beats 파이프라인 구성.
- Observability, Elastic Security, APM 워크플로 패턴.
Elastic 스킬은 npx로 skills CLI를 사용하거나, elastic/agent-skills 저장소를 클론한 뒤 함께 제공되는 설치 스크립트를 실행해 설치할 수 있습니다. npx 방식은 환경에 npx를 사용할 수 있는 Node.js가 필요합니다.
스킬을 설치하는 가장 빠른 방법은 skills CLI를 사용하는 것입니다. 다음 명령을 실행하면 스킬과 대상 에이전트를 선택할 수 있는 대화형 프롬프트가 실행됩니다:
npx skills add elastic/agent-skills
특정 스킬을 이름으로 설치합니다:
npx skills add elastic/agent-skills --skill elasticsearch-esql
또는 @ 축약형을 사용해 스킬을 repo@skill 형태로 직접 지정합니다(--skill과 동일):
npx skills add elastic/agent-skills@elasticsearch-esql
특정 에이전트에 설치합니다:
npx skills add elastic/agent-skills -a cursor -a claude-code
설치하지 않고 사용 가능한 스킬 목록을 확인합니다:
npx skills add elastic/agent-skills --list
프롬프트 없이 모든 스킬을 모든 에이전트에 설치합니다:
npx skills add elastic/agent-skills --all
| 플래그 | 설명 |
|---|---|
-a, --agent |
특정 에이전트를 대상으로 지정합니다. |
-s, --skill |
특정 스킬을 이름으로 설치합니다. |
-g, --global |
프로젝트 디렉터리 대신 사용자 홈에 설치합니다. |
-y, --yes |
확인 프롬프트를 건너뜁니다. |
--all |
프롬프트 없이 모든 스킬을 모든 에이전트에 설치합니다. |
--list |
설치하지 않고 사용 가능한 스킬을 나열합니다. |
로컬 체크아웃에서 작업하는 것을 선호하거나 환경에 Node.js 또는 npx가 없다면, 저장소를 클론하고 함께 제공되는 bash 설치 스크립트를 사용하세요:
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 |
확인 프롬프트를 건너뜁니다. |
다음 AI 코딩 에이전트가 Agent Skills 형식과 호환됩니다:
| 에이전트 | 설치 디렉터리 |
|---|---|
| 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 |
스킬은 설치 시점에 프로젝트 또는 홈 디렉터리로 복사됩니다. 저장소가 새로운 지침, 버그 수정, 추가 리소스로 업데이트되어도 그 변경 사항이 로컬 복사본에 자동으로 동기화되지는 않습니다.
업데이트 절차는 스킬을 어떤 방식(npx 또는 로컬 클론)으로 설치했는지에 따라 달라집니다.
설치된 스킬 중 업스트림에서 변경된 것이 있는지 확인합니다:
npx skills check
설치된 모든 스킬의 최신 버전을 가져옵니다:
npx skills update
기본 npx 설치는 심볼릭 링크를 사용하므로 모든 에이전트가 하나의 정본 복사본을 가리킵니다. 한 번 업데이트하면 모든 에이전트가 동시에 갱신됩니다.
기존 스킬을 덮어쓰려면 --force와 함께 설치 스크립트를 다시 실행하세요:
git pull
./scripts/install-skills.sh add -a <agent> --force
--force가 없으면 스크립트는 이미 설치된 스킬을 건너뜁니다.
문제를 발견했거나 제안할 내용이 있나요? elastic/agent-skills 저장소에서 이슈를 열어주세요.