Google Antigravity Agent Skills (에이전트 스킬)

에이전트의 능력을 확장하는 표준 규격, 안티그래비티(Antigravity)의 Skills

구글의 안티그래비티(Antigravity) 플랫폼에서 Skills(스킬)은 에이전트의 기능을 특정 작업에 맞춰 확장하고 최적화할 수 있도록 설계된 오픈 표준입니다. 단순히 대화를 나누는 것을 넘어, 에이전트가 특정 워크플로우나 지식 체계를 바탕으로 일관성 있게 행동하게 만드는 '전문 지식 패키지'라고 볼 수 있습니다.

---

Skills의 핵심 개념과 구조

Skills는 기본적으로 SKILL.md라는 파일이 포함된 폴더 형태의 구조를 가집니다. 이 파일 안에는 에이전트가 특정 상황에서 어떻게 행동해야 하는지에 대한 지침이 담겨 있습니다.

• 자율적인 활성화: 사용자가 매번 스킬을 사용하라고 지시할 필요가 없습니다. 에이전트가 대화의 맥락을 파악하고 사용 가능한 스킬 목록 중 가장 적절한 것을 스스로 선택해 지침을 읽고 실행합니다.
• 재사용 가능한 지식: 한 번 정의된 스킬은 여러 프로젝트나 워크스페이스에서 반복적으로 사용할 수 있어 에이전트의 전문성을 누적시킬 수 있습니다.
• 범위(Scope)의 유연성: 특정 프로젝트 폴더(.agent/skills/) 내에서만 작동하는 '워크스페이스 스킬'과 모든 프로젝트에서 공통으로 사용하는 '글로벌 스킬'로 나누어 관리할 수 있습니다.

---

Skill 폴더 구성 예시

단순히 명령문만 넣는 것이 아니라, 에이전트가 참고할 수 있는 리소스들을 함께 패키징할 수 있습니다.

구성 요소	설명	비고
SKILL.md	스킬의 이름, 설명, 구체적인 지침이 담긴 핵심 파일	필수
scripts/	작업을 돕는 자동화 스크립트나 도구들	선택
examples/	에이전트가 참고할 수 있는 모범 사례나 구현 예시	선택
templates/	문서 작성이나 코드 생성을 위한 기본 양식	선택

---

실제 활용 예시 1: 단위 테스트 생성 스킬 (Python)

개발자가 파이썬 코드를 작성할 때, 팀의 규칙에 맞춰 테스트 코드를 자동으로 짜주는 스킬을 구축할 수 있습니다.

• 스킬 설명 (Description): pytest 컨벤션을 사용하여 파이썬 코드의 단위 테스트를 생성합니다.
• 지침 내용:
• 테스트 파일 이름은 항상 test_로 시작할 것.
• 모든 함수에 대해 최소 3개 이상의 엣지 케이스(Edge Case)를 포함할 것.
• Mock 라이브러리를 사용하여 외부 API 호출을 시뮬레이션할 것.

• 효과: 개발자가 "이 함수 테스트 코드 짜줘"라고만 말해도, 에이전트가 해당 스킬을 불러와서 복잡한 규칙을 모두 준수한 코드를 생성합니다.

---

실제 활용 예시 2: 기업 브랜드 보이스 가이드 스킬

마케팅 팀에서 블로그 글이나 보도자료를 작성할 때, 회사의 브랜드 아이덴티티를 유지하도록 돕는 스킬입니다.

• 스킬 설명 (Description): 회사의 공식 브랜드 보이스와 톤앤매너를 적용하여 텍스트를 교정합니다.
• 지침 내용:
• 전문적이면서도 친근한 서술어(~해요 체)를 사용할 것.
• IT 전문 용어 사용 시 반드시 쉬운 설명을 덧붙일 것.
• 경쟁사를 직접적으로 비하하는 표현은 피할 것.

• 효과: 어떤 에이전트와 대화하더라도 동일한 브랜드 가이드라인이 적용된 결과물을 얻을 수 있습니다.

---

효율적인 Skills 작성을 위한 팁

안티그래비티 Skills를 더 잘 활용하기 위해서는 에이전트가 스킬을 '발견'하기 쉽게 만들어야 합니다.

• 명확한 메타데이터 작성: SKILL.md 상단의 YAML 영역에 들어가는 description을 제3자 관점에서 구체적으로 적으세요. 에이전트는 이 설명을 읽고 스킬 사용 여부를 결정합니다.
• 단계별 가이드 제공: 복잡한 작업은 의사결정 트리(Decision Tree)나 단계별 체크리스트를 포함하여 에이전트가 논리적으로 판단하도록 유도하세요.
• 스크립트 활용: 에이전트에게 소스 코드를 다 읽게 하기보다, --help 옵션이 있는 실행 가능한 스크립트를 제공하여 에이전트의 컨텍스트(기억 공간)를 절약하세요.