Gemini CLI Skills: Teaching Your Terminal Agent How to Think 🧠

개요

Gemini CLI의 Skills 기능은 일반적인 작업에 능숙한 에이전트를 특정 워크플로우에 대한 전문가로 전환시키는 방법입니다. Skills는 온디맨드 방식으로 로드되어 컨텍스트 창을 효율적으로 관리하며, 2024년 6월 18일부터 Antigravity CLI로 전환될 예정이지만 Skills의 작동 방식은 동일하게 유지됩니다.

주요 내용

* Skills란 무엇인가: Skills는 특정 지침과 컨텍스트를 패키징하여 검색 가능한 기능으로 만드는 자체 포함 디렉터리입니다. GEMINI.md 파일과 달리 Skills는 에이전트가 관련성이 있다고 판단할 때만 온디맨드 방식으로 로드되어 컨텍스트 오염을 방지합니다.
* Skills의 구조: Skills는 .gemini/skills/ 디렉터리 내에 위치하며, 필수 파일인 SKILL.md와 선택적 파일인 examples/, resources/, scripts/로 구성됩니다.
* SKILL.md 파일: SKILL.md 파일은 Skills의 핵심으로, name, description 필드를 포함하는 frontmatter 헤더와 실제 지침 본문으로 구성됩니다. description 필드는 에이전트가 Skill의 관련성을 판단하는 데 사용됩니다.
* Skills의 위치: 프로젝트별 Skills는 .gemini/skills/에, 개인 또는 범용 Skills는 ~/.gemini/skills/에 저장되어 팀 또는 개인 워크플로우에 맞게 구성할 수 있습니다.
* Skills 생성 단계:
1. 프로젝트 또는 홈 디렉터리에 Skill 디렉터리 생성.
2. SKILL.md 파일에 Skill의 이름, 설명, 지침 작성 (예: 코드 리뷰, Conventional Commits).
3. Gemini CLI에서 /skills 명령어로 Skill이 정상적으로 인식되는지 확인.
4. 자연스러운 대화 형식으로 Skill을 활용 (예: 코드 리뷰 요청 시 자동으로 Skill 활성화).
* Skills vs. GEMINI.md: GEMINI.md는 에이전트가 항상 필요로 하는 정보(프로젝트 기본 정보, 일반 코딩 표준)에 사용되며, Skills는 특정 상황에만 필요한 전문화된 워크플로우(배포, 코드 리뷰, 특정 도메인 전문 지식)에 사용됩니다.
* 좋은 Skills 작성 팁: 설명은 구체적이고 좁게 작성하며, 필요시 "사용하지 마세요" 힌트를 추가합니다. SKILL.md는 간결하게 유지하고, 복잡한 예제는 별도 디렉터리에 저장합니다. 각 Skill은 단일 책임을 갖도록 하고, 예상대로 활성화되는지 테스트합니다.

시사점

Skills는 Gemini CLI(또는 Antigravity CLI)를 일반적인 AI 어시스턴트에서 팀의 규약과 프로세스를 이해하는 도구로 전환시키는 핵심 기능입니다. Skills를 통해 에이전트는 더욱 개인화되고 효율적인 방식으로 사용자의 요구를 충족하며, 궁극적으로는 동료처럼 느껴지게 만들 수 있습니다.