구글이 내놓은 에이전틱 코딩 도구 Antigravity를 쓰다 보면 Skills라는 기능을 자주 마주치게 돼요. Skills는 에이전트가 특정 작업을 수행할 때 참고하는 재사용 가능한 지식 패키지인데, 어떻게 사용하는지 감이 잘 안 잡히는 분들이 많아서 사용법을 정리해봤어요.
Skills가 정확히 무엇인가
Antigravity의 Skill은 SKILL.md 파일을 중심으로 구성된 폴더예요. 이 파일 안에는 에이전트가 특정 유형의 작업을 처리할 때 따라야 할 지침, 모범 사례, 규칙이 담겨 있어요. 필요하다면 스크립트나 참고 자료 같은 보조 파일도 함께 넣을 수 있어요.
대화가 시작되면 에이전트는 사용 가능한 스킬 목록을 먼저 확인해요. 그리고 현재 작업과 관련이 있어 보이는 스킬을 발견하면, 그 스킬의 전체 지침을 읽고 작업에 반영하는 방식으로 동작해요. 이렇게 필요할 때만 불러오는 구조라 컨텍스트 낭비를 줄일 수 있어요.
Skills 사용을 시작하는 방법
Antigravity에서 Skills를 사용하려면 먼저 프로젝트 안에 스킬 폴더를 구성해야 해요. 각 스킬은 자기만의 폴더를 가지고, 그 안에 SKILL.md 파일이 필수로 들어가요.
- SKILL.md 작성 – 스킬의 이름, 설명, 그리고 구체적인 실행 절차를 마크다운으로 적어요.
- 보조 자료 추가 – 필요하다면 scripts, examples, resources 폴더에 스크립트나 템플릿을 함께 넣어요.
- 스킬 목록 확인 – 에이전트가 대화 시작 시 스킬 목록을 스캔하므로, 이름과 설명을 명확하게 적는 게 중요해요.
실제 작업에서 Skills가 호출되는 방식
에이전트는 사용자의 요청을 분석한 뒤, 등록된 스킬 목록 중에서 관련성이 높아 보이는 스킬을 판단해서 불러와요. 예를 들어 배포 관련 작업을 요청하면 ‘배포’ 관련 스킬이 자동으로 선택되고, 그 안의 지침을 따라 작업을 진행하는 식이에요.
스킬이 자동으로 로드되는 방식 덕분에 매번 같은 지침을 반복해서 설명할 필요가 없어져요. 특히 팀 단위로 반복되는 작업 패턴이 있다면, 이를 스킬로 만들어두는 것만으로도 작업 일관성을 크게 높일 수 있어요.
Rules와의 차이점
Antigravity에는 Skills 외에도 Rules라는 기능이 따로 있어서 혼동하는 경우가 많아요. 두 기능은 목적이 명확히 다르기 때문에 구분해서 이해하는 게 중요해요.
Rules는 에이전트가 항상 지켜야 하는 제약 조건이에요. 코드 스타일, 금지 사항, 보안 정책처럼 예외 없이 적용돼야 하는 규칙을 정의할 때 사용해요. 반면 Skills는 특정 상황에서만 호출되는 전문화된 역할과 실행 절차예요.
구글 공식 문서에서도 두 기능이 상호 보완적이라며, Antigravity를 본격적으로 활용하려면 Rules와 Skills를 함께 설정하는 것을 권장하고 있어요.
Skills 활용 시 주의할 점
스킬을 너무 많이 만들면 오히려 에이전트가 어떤 스킬을 선택해야 할지 혼란스러워할 수 있어요. 스킬 이름과 설명을 명확하고 구체적으로 작성해서, 서로 겹치지 않도록 관리하는 게 중요해요.
- 명확한 네이밍 – 스킬 이름만 봐도 어떤 상황에 쓰이는지 알 수 있게 작성해요.
- 범위 제한 – 하나의 스킬에 너무 많은 기능을 몰아넣지 말고 역할별로 분리해요.
- 버전 관리 – 스킬 내용이 자주 바뀐다면 변경 이력을 기록해두는 게 좋아요.
Skills를 활용하면 좋은 상황
반복적인 코드 리뷰 기준, 특정 프레임워크의 컨벤션, 사내 배포 절차처럼 매번 설명하기 번거로운 작업일수록 Skills로 만들어두면 효과가 커요. 외부에서 제공하는 스킬 팩을 설치해서 검색, 슬라이드 생성 같은 기능을 바로 추가하는 것도 가능해요.
Skills 기능을 잘 활용하면 매번 같은 맥락을 반복 설명하지 않고도 일관된 결과물을 얻을 수 있어요. 처음에는 익숙하지 않을 수 있지만, 자주 반복하는 작업부터 하나씩 스킬로 만들어보면 Antigravity 활용도가 눈에 띄게 올라갈 거예요.