구글 안티그래비티 Skills:
모르면 에이전트가 반쪽짜리
2026년 1월 13일 출시된 신기능 — 지금도 90%가 기본 채팅만 쓰고 있습니다
🤖 Gemini 3 Pro 내장
⚡ 컨텍스트 비용 최대 60% 절감
🆓 무료 계정 사용 가능
구글 안티그래비티 Skills는 AI 에이전트가 “범용 도구”에서 벗어나 여러분의 프로젝트와 팀 고유의 규칙을 기억하는 전문가로 진화하게 만드는 핵심 기능입니다. 단순히 채팅으로 명령만 내리던 방식과 달리, Skills를 한 번 설정해두면 에이전트가 스스로 판단해 적절한 지식 모듈을 꺼내 씁니다. 코딩 컨벤션, 배포 절차, 보안 정책 — 이 모든 것을 에이전트의 장기기억처럼 심어둘 수 있습니다.
2026년 현재 구글 안티그래비티를 쓰는 개발자 대부분이 에이전트와 채팅만 하고 있습니다. Skills를 모른다면 Antigravity의 진짜 힘을 절반도 못 쓰고 있는 셈입니다.
🧠 구글 안티그래비티 Skills란? 왜 지금 써야 하나
구글 안티그래비티는 Gemini 3 모델을 기반으로 작동하는 에이전트 퍼스트(Agent-First) IDE입니다. 단순한 코드 자동완성 도구가 아니라, 계획(Plan) → 실행(Execute) → 검증(Verify) 사이클을 자율적으로 돌리는 AI 개발 파트너에 가깝습니다. 그리고 2026년 1월 13일, 이 에이전트의 능력을 무한 확장하는 기능인 Skills가 정식 출시되었습니다.
Skills의 핵심 철학은 Progressive Disclosure(점진적 노출)입니다. 기존 방식처럼 프로젝트의 모든 규칙, 문서, 컨벤션을 에이전트에게 한꺼번에 주입하면 컨텍스트가 과부하되어 추론 품질이 떨어지고 토큰 비용이 폭증합니다. Skills는 이 문제를 근본적으로 해결합니다. 에이전트는 대화가 시작될 때 Skills의 이름과 간략한 설명만 확인하다가, 해당 작업이 필요하다고 판단되는 순간에만 해당 Skill의 전체 내용을 로딩합니다. 필요할 때만, 딱 그것만 꺼내 씁니다.
💡 인사이트: 구글 내부 데이터에 따르면 Skills를 활용한 에이전트는 동일 작업 대비 컨텍스트 토큰 소비를 최대 60% 줄이고, 작업 완료율이 유의미하게 향상됩니다. “더 많이 알려줄수록 더 잘한다”는 기존 상식을 뒤집는 설계입니다.
실제로 “인증 미들웨어를 리팩터링해 달라”는 요청에 CSS 빌드 파이프라인이나 마케팅 텍스트 규칙이 왜 필요하겠습니까? Skills 이전에는 이 모든 정보를 Rules에 한꺼번에 적어놓는 수밖에 없었고, 그 결과 에이전트는 불필요한 정보의 홍수 속에서 엉뚱한 판단을 내리곤 했습니다. Skills는 이 구조적 문제를 해결하는 돌파구입니다.
⚖️ Skills vs Rules vs Workflows: 헷갈리면 절대 못 쓴다
안티그래비티를 처음 접하면 세 가지 개념이 비슷해 보여서 혼동하기 쉽습니다. 그러나 이 세 가지는 역할이 명확히 다르며, 각각의 자리가 있습니다. 이것을 구분하지 못하면 엉뚱한 곳에 설정을 넣게 되고, 에이전트는 기대한 대로 움직이지 않습니다.
| 구분 | Rules | Workflows | Skills |
|---|---|---|---|
| 적용 시점 | 항상 (Always On) | 사용자 호출 시 | 에이전트 자동 판단 |
| 컨텍스트 로딩 | 매 대화 주입 | 호출 시 주입 | 필요 시만 주입 |
| 활용 예시 | 코드 스타일, 금지 명령 | /deploy, /test | 코드 리뷰, DB 마이그레이션 |
| 호출 방식 | 자동 | 슬래시 커맨드(/) | 자동 (명시 가능) |
Rules는 절대 지켜야 할 제약 조건입니다. “절대 시크릿 키를 커밋하지 말 것”, “PEP 8 스타일 가이드를 따를 것” 같은 전사 공통 규칙은 Rules에 넣는 것이 맞습니다. 에이전트가 무슨 작업을 하든 항상 이 규칙은 머릿속에 있어야 하기 때문입니다.
Workflows는 여러 단계를 묶은 매크로와 같습니다. /deploy-staging이라는 Workflow를 만들어두면, 해당 슬래시 커맨드를 입력하는 순간 에이전트가 빌드→테스트→배포 단계를 순서대로 실행합니다. 사람이 직접 호출해야 작동한다는 것이 핵심입니다.
Skills는 에이전트 스스로 “아, 지금 이 작업에는 이 지식이 필요하겠군” 하고 판단해서 꺼내 쓰는 전문 지식 모듈입니다. 개인적으로 이 세 가지 중 Skills가 가장 강력하다고 생각합니다. 매번 슬래시 커맨드를 입력하거나 Rules에 모든 것을 우겨넣을 필요 없이, 에이전트가 알아서 맥락에 맞는 행동 방식을 선택하기 때문입니다.
🛠️ Skills 설치·구조 설정 완전 가이드
Skills를 사용하기 위해 별도 플러그인을 설치할 필요는 없습니다. 구글 안티그래비티가 이미 설치되어 있다면 Skills 디렉터리를 만드는 것만으로 바로 시작할 수 있습니다. 중요한 것은 저장 위치에 따라 적용 범위가 달라진다는 점입니다.
Skills 저장 위치 두 가지
📁 워크스페이스 범위: <workspace-root>/.agent/skills/<skill-folder>/
→ 해당 프로젝트에서만 사용. 팀 공유 .gitignore 설정 시 팀 전체 적용 가능
🌐 글로벌 범위: ~/.gemini/antigravity/skills/<skill-folder>/
→ 내 컴퓨터의 모든 프로젝트에 공통 적용
Skill 폴더 기본 구조
Skills의 최소 구성은 폴더 하나와 SKILL.md 파일 하나입니다. 그 이상은 선택 사항입니다.
my-skill/
├── SKILL.md # 필수: 메타데이터 + 지시사항
├── scripts/ # 선택: Python·Bash 실행 스크립트
├── references/ # 선택: 참고 문서, 템플릿, 텍스트
└── assets/ # 선택: 이미지, 로고 등 정적 자원SKILL.md 작성 핵심 규칙
SKILL.md의 상단에는 반드시 YAML Frontmatter가 들어가야 합니다. 여기서 가장 중요한 필드는 description입니다. 에이전트가 이 설명을 읽고 “지금 이 Skill이 필요한가”를 판단하기 때문입니다. 설명이 애매하면 에이전트가 Skill을 꺼내 쓰지 않습니다.
---
name: code-review
description: Performs code review for pull requests or code changes.
Checks correctness, edge cases, style conventions,
and performance. Use when reviewing or auditing code quality.
# Code Review Skill
## Review Checklist
1. **Correctness**: Does the code do what it should?
2. **Edge Cases**: Are error conditions handled?
3. **Style**: Does it follow project conventions?
4. **Performance**: Any obvious inefficiencies?
## How to Provide Feedback
- Be specific about what needs to change
- Explain why, not just what
- Suggest alternatives when possible💡 핵심 팁: description은 3인칭으로 쓰고, 에이전트가 언제 이 Skill을 쓸지 알 수 있는 트리거 키워드를 반드시 포함하세요. “Use when reviewing PRs or checking code quality”처럼 상황을 명시하는 것이 효과적입니다.
🎯 실전 Skills 5단계: 초급→중급→고급 레시피
구글 공식 Codelab에서는 Skills를 5가지 레벨로 나눠 소개합니다. 레벨이 올라갈수록 단순한 지침에서 벗어나 스크립트를 실행하고 외부 자원을 활용하는 진짜 전문가형 Skill로 발전합니다. 각 레벨을 이해하면 내 팀에 맞는 Skill을 어떤 수준으로 만들지 판단하는 데 큰 도움이 됩니다.
Lv.1
기본 라우터 — git-commit-formatter
커밋 메시지를 Conventional Commits 규칙(feat:, fix:, docs: 등)에 맞춰 자동 포맷팅합니다. 코드가 없고 지침만 담긴 가장 단순한 형태입니다. 에이전트가 커밋 관련 작업을 감지하면 자동으로 이 Skill을 활성화해 메시지 형식을 교정합니다.
Lv.2
외부 자원 활용 — license-header-adder
저작권 헤더 텍스트처럼 긴 내용을 references/HEADER.txt로 분리하고, 에이전트는 새 파일 생성 시에만 이 텍스트를 읽어 헤더를 추가합니다. C계열과 Python의 주석 문법 차이도 자동으로 구분해 적용하는 것이 포인트입니다.
Lv.3
Few-Shot 학습 — json-to-pydantic
SKILL.md 안에 입력(JSON 예시)과 기대 출력(Pydantic 모델 코드)을 쌍으로 여러 개 제공합니다. 에이전트는 이 예시들을 보고 패턴을 학습해 새로운 JSON 구조를 Pydantic 모델로 정확하게 변환합니다. Few-Shot 예시가 많을수록 변환 정확도가 올라갑니다.
Lv.4
절차적 로직 + 스크립트 — database-schema-validator
LLM의 주관적 판단 대신 Python 스크립트를 실행한 결과값을 기준으로 DB 스키마를 검증합니다. scripts/validate.py가 오류를 발견하면 에이전트는 그 결과를 바탕으로 수정 작업을 진행합니다. “AI 판단”이 아닌 “실행 결과”에 기반하므로 신뢰성이 크게 올라갑니다.
Lv.5
아키텍트 패턴 — adk-tool-scaffold
템플릿, Few-Shot 예시, 스크립트를 모두 조합해 Google ADK(Agent Development Kit)용 Tool을 자동 생성합니다. 새 API 연동 작업이 들어올 때마다 에이전트가 이 Skill을 활성화해 보일러플레이트 코드 전체를 자동으로 구성합니다. 단순 Skill을 넘어 사실상 미니 자동화 시스템입니다.
🔗 Skills + MCP 조합: 에이전트에 손과 뇌를 동시에
구글 안티그래비티 Skills는 MCP(Model Context Protocol)와 조합할 때 비로소 진짜 위력을 발휘합니다. MCP는 GitHub, Slack, 데이터베이스 같은 외부 시스템과 에이전트를 연결하는 클라이언트-서버 구조의 프로토콜입니다. 이 둘의 관계를 한 줄로 요약하면 이렇습니다. MCP는 에이전트의 “손”이고, Skills는 에이전트의 “뇌”입니다.
예를 들어 GitHub MCP 서버를 연결해두면 에이전트는 PR 정보를 직접 읽어올 수 있습니다. 여기에 code-review Skill까지 설정해두면, “PR #142 리뷰해줘”라는 말 한마디로 에이전트가 스스로 PR을 가져오고, code-review Skill의 체크리스트에 따라 분석한 뒤, 구체적인 피드백 코멘트를 작성합니다. 개발자가 별도로 코드를 복사해 붙여넣을 필요가 전혀 없습니다.
| 기술 | 역할 | 특징 |
|---|---|---|
| MCP | 외부 시스템 연동 (손) | 서버-클라이언트, 지속 연결 |
| Skills | 전문 지식 모듈 (뇌) | 파일 기반, 서버리스, 온디맨드 |
| Rules | 전역 제약 조건 (척추) | 항상 활성, 시스템 프롬프트 주입 |
| Workflows | 반복 절차 자동화 (매크로) | 슬래시 커맨드로 호출 |
Reddit의 구글 안티그래비티 커뮤니티에서 실제 사용자들이 공유한 Skill 중 가장 인기 있는 것들은 /audit(기술 부채 8가지 벡터 분석), code-review(PR 자동 리뷰), 그리고 팀 배포 파이프라인 Skill입니다. 이처럼 Skills는 개인 생산성 도구를 넘어 팀 전체의 개발 문화를 코드화하는 수단이 되고 있습니다.
⚠️ 주의할 점과 현실적 한계 — 솔직하게 말씀드립니다
Skills가 강력한 기능인 것은 사실이지만, 맹신하면 낭패를 봅니다. 실제로 Reddit의 공식 커뮤니티(r/google_antigravity)에는 “Skills 기능이 의도대로 작동하지 않는다”는 불만이 꽤 올라와 있습니다. 이 글에서는 그 원인을 솔직하게 짚어드립니다.
첫 번째는 description 품질 문제입니다. 에이전트가 Skill을 선택하는 근거는 오직 description 필드입니다. 이것이 모호하게 작성되면 에이전트가 Skill을 무시하거나, 반대로 관련 없는 작업에 엉뚱하게 활성화합니다. “Helps with coding tasks” 같은 너무 포괄적인 설명은 쓸모가 없습니다.
두 번째는 스크립트 보안 경계입니다. Lv.4 이상부터는 Python 또는 Bash 스크립트를 Skills에 포함할 수 있는데, 안티그래비티의 터미널 자동 실행 보안 설정이 엄격하게 걸려 있으면 스크립트가 실행을 거부당하는 경우가 있습니다. Antigravity Settings → Advanced Settings → Terminal에서 허용 수준을 조절해야 합니다.
🚨 주의: 터미널 자동 실행을 ‘제한 없음’ 모드로 설정하면 에이전트가 rm, sudo 같은 위험한 명령어도 실행할 수 있습니다. 반드시 허용할 명령어 범위를 직접 지정하는 방식을 권장합니다.
세 번째는 컨텍스트 한계와 Skill 충돌입니다. 글로벌 Skills를 너무 많이 만들어두면 에이전트가 대화 시작 시 모든 Skill 설명을 훑어봐야 하므로 초기 지연이 생깁니다. Skill은 하나가 하나의 일만 잘하도록(Single Responsibility) 설계하고, 자주 쓰지 않는 Skill은 워크스페이스 범위로 분리하는 것이 좋습니다.
네 번째로, 아직 한국어 최적화가 완벽하지 않습니다. SKILL.md를 한국어로 작성했을 때 description 인식률이 영어 대비 다소 낮다는 사용자 보고가 있습니다. 현재로서는 description만큼은 영어로 작성하고 나머지 Instructions는 한국어로 작성하는 혼합 방식이 가장 안정적입니다.
❓ 자주 묻는 질문 Q&A
✍️ 마치며 — Skills, 에이전트를 진짜 동료로 만드는 열쇠
구글 안티그래비티 Skills는 단순한 신기능이 아닙니다. “AI 에이전트를 어떻게 훈련할 것인가”라는 질문에 대한 구글의 실용적인 답안입니다. 범용 모델에게 매번 상황을 설명하는 것이 아니라, 조직의 지식과 절차를 Skills로 코드화해두면 에이전트는 새로운 팀원처럼 처음부터 우리 팀의 방식을 알고 일하게 됩니다.
2026년 현재 AI 에이전트 도구 경쟁이 치열해지고 있습니다. Cursor, Claude Code, GitHub Copilot 모두 훌륭하지만, Antigravity Skills처럼 “팀 지식을 에이전트에 영구적으로 이식하는” 표준화된 방법론은 아직 다른 도구에서는 이 수준으로 지원되지 않습니다. 지금 Lv.1짜리 Skills 하나라도 만들어보세요. 며칠 지나면 에이전트가 알아서 하던 일을 또 해주는 경험을 하게 됩니다.
외부 링크 참고: 구글 안티그래비티 공식 문서 / Skills Codelab (한국어)
본 포스팅은 2026년 3월 9일 기준으로 작성되었으며, 구글 안티그래비티의 기능 및 정책은 업데이트에 따라 변경될 수 있습니다. 공식 문서(antigravity.google/docs)에서 최신 정보를 확인하시기 바랍니다.
댓글 남기기