에이전트 스킬
에이전트 스킬을 사용하면 전문적인 지식, 절차적 워크플로 및 작업별 리소스로 Gemini CLI를 확장할 수 있습니다. Agent Skills (opens in a new tab) 개방형 표준을 기반으로 하는 "스킬"은 지침과 자산을 검색 가능한 기능으로 패키징하는 독립적인 디렉터리입니다.
개요
지속적인 작업 공간 전체 배경을 제공하는 일반 컨텍스트 파일(GEMINI.md)과
달리, 스킬은 **주문형 전문성(on-demand expertise)**을 나타냅니다. 이를 통해 Gemini는 모델의
즉각적인 컨텍스트 창을 어지럽히지 않고도 보안 감사, 클라우드 배포 또는 코드베이스 마이그레이션과
같은 방대한 전문 기능 라이브러리를 유지할 수 있습니다.
Gemini는 사용자의 요청과 스킬 설명을 기반으로 스킬을 사용할 시기를 자율적으로 결정합니다.
관련 스킬이 식별되면 모델은 activate_skill 도구를 사용하여 작업을 완료하는 데 필요한
전체 지침과 리소스를 "가져옵니다".
주요 이점
- 공유된 전문성: 복잡한 워크플로(예: 특정 팀의 PR 검토 프로세스)를 누구나 사용할 수 있는 폴더로 패키징합니다.
- 반복 가능한 워크플로: 절차적 프레임워크를 제공하여 복잡한 다단계 작업이 일관되게 수행되도록 보장합니다.
- 리소스 번들링: 에이전트가 필요한 모든 것을 갖도록 지침과 함께 스크립트, 템플릿 또는 예제 데이터를 포함합니다.
- 점진적 공개: 처음에는 스킬 메타데이터(이름 및 설명)만 로드됩니다. 상세 지침과 리소스는 모델이 스킬을 명시적으로 활성화할 때만 공개되므로 컨텍스트 토큰을 절약합니다.
스킬 검색 계층
Gemini CLI는 세 가지 기본 위치에서 스킬을 검색합니다:
- 작업 공간 스킬 (Workspace Skills) (
.gemini/skills/): 일반적으로 버전 제어에 커밋되고 팀과 공유되는 작업 공간별 스킬입니다. - 사용자 스킬 (User Skills) (
~/.gemini/skills/): 모든 작업 공간에서 사용할 수 있는 개인 스킬입니다. - 확장 스킬 (Extension Skills): 설치된 확장 내에 번들로 제공되는 스킬입니다.
우선순위: 여러 스킬이 동일한 이름을 공유하는 경우, 높은 우선순위 우위가 낮은 위치를 재정의합니다: 작업 공간 > 사용자 > 확장.
스킬 관리
대화형 세션에서
/skills 슬래시 명령을 사용하여 사용 가능한 전문성을 보고 관리합니다:
/skills list(기본값): 발견된 모든 스킬과 상태를 표시합니다./skills link <path>: 심볼릭 링크를 통해 로컬 디렉터리의 에이전트 스킬을 연결합니다./skills disable <name>: 특정 스킬이 사용되지 않도록 방지합니다./skills enable <name>: 비활성화된 스킬을 다시 활성화합니다./skills reload: 모든 계층에서 발견된 스킬 목록을 새로 고칩니다.
참고: /skills disable 및 /skills enable은 기본적으로 user 범위를 사용합니다.
작업 공간별 설정을 관리하려면 --scope workspace를 사용하세요.
터미널에서
gemini skills 명령은 관리 유틸리티를 제공합니다:
# 발견된 모든 스킬 나열
gemini skills list
# 심볼릭 링크를 통해 로컬 디렉터리의 에이전트 스킬 연결
# 스킬(SKILL.md 또는 */SKILL.md)을 발견하고 ~/.gemini/skills (user)에 심볼릭 링크 생성
gemini skills link /path/to/my-skills-repo
# 작업 공간 범위(.gemini/skills)에 연결
gemini skills link /path/to/my-skills-repo --scope workspace
# Git 저장소, 로컬 디렉터리 또는 압축된 스킬 파일(.skill)에서 스킬 설치
# 기본적으로 사용자 범위(~/.gemini/skills) 사용
gemini skills install https://github.com/user/repo.git
gemini skills install /path/to/local/skill
gemini skills install /path/to/local/my-expertise.skill
# --path를 사용하여 모노레포 또는 하위 디렉터리에서 특정 스킬 설치
gemini skills install https://github.com/my-org/my-skills.git --path skills/frontend-design
# 작업 공간 범위(.gemini/skills)에 설치
gemini skills install /path/to/skill --scope workspace
# 이름으로 스킬 제거
gemini skills uninstall my-expertise --scope workspace
# 스킬 활성화 (전역)
gemini skills enable my-expertise
# 스킬 비활성화. --scope를 사용하여 작업 공간 또는 사용자 지정 가능 (기본값은 작업 공간)
gemini skills disable my-expertise --scope workspace작동 방식
- 검색 (Discovery): 세션 시작 시 Gemini CLI는 검색 계층을 스캔하고 활성화된 모든 스킬의 이름과 설명을 시스템 프롬프트에 주입합니다.
- 활성화 (Activation): Gemini가 스킬 설명과 일치하는 작업을 식별하면
activate_skill도구를 호출합니다. - 동의 (Consent): 스킬의 이름, 목적 및 액세스할 수 있는 디렉터리 경로를 자세히 설명하는 확인 프롬프트가 UI에 표시됩니다.
- 주입 (Injection): 승인 시:
SKILL.md본문과 폴더 구조가 대화 기록에 추가됩니다.- 스킬의 디렉터리가 에이전트의 허용된 파일 경로에 추가되어 번들로 제공된 모든 자산을 읽을 수 있는 권한을 부여합니다.
- 실행 (Execution): 모델은 전문 지식이 활성화된 상태로 진행합니다. 합리적인 범위 내에서 스킬의 절차적 지침을 우선시하도록 지시받습니다.
스킬 활성화
스킬이 활성화되면(일반적으로 Gemini가 스킬 설명과 일치하는 작업을 식별하고 사용자가 승인함에 따라), 해당 스킬의 전문 지침과 리소스가 에이전트의 컨텍스트로 로드됩니다. 스킬은 세션 기간 동안 활성 상태로 유지되며 그 지침이 우선시됩니다.
나만의 스킬 만들기
나만의 스킬을 만들려면 에이전트 스킬 만들기 가이드를 참조하세요.