2026년 3월 최신 v1.20.5 기준
구글 안티그래비티 Skills 완전정복
코딩을 몰라도 내 전용 AI 비서를 만드는 결정적 방법
⚡ 현재 무료
🤖 Gemini 3 탑재
구글 안티그래비티(Google Antigravity)가 2025년 11월 출시된 이후, 이미 수백만 명의 개발자와 비개발자가 이 도구로 앱·웹사이트·자동화 워크플로를 코드 한 줄 없이 만들어내고 있습니다. 그중에서도 Skills 기능은 에이전트에게 “내가 원하는 방식대로만 일하는 전문성”을 심어주는 핵심 기능임에도, 한국어로 제대로 정리된 콘텐츠가 사실상 없습니다. 이 글에서 비개발자도 오늘 바로 따라 할 수 있도록 처음부터 끝까지 해설합니다.
🧠 구글 안티그래비티 Skills가 뭐길래 이렇게 중요한가?
구글 안티그래비티(Google Antigravity)는 구글 딥마인드가 2025년 11월 18일 출시한 에이전트 중심 AI 개발 환경으로, 현재 v1.20.5(2026년 3월 9일 업데이트)까지 빠르게 발전하고 있습니다. 기존의 코드 편집기(VS Code, Cursor 등)가 “개발자가 코드를 작성하면 AI가 보조하는” 구조였다면, 안티그래비티는 정반대입니다. AI 에이전트가 주도적으로 계획을 세우고 실행하고 검증까지 하는 구조입니다. 그 중심에 있는 것이 바로 Skills(스킬)입니다.
Skills를 한 줄로 정의하면 “에이전트에게 특정 도메인의 전문성을 심어주는 가볍고 개방된 지식 패키지”입니다. 예를 들어 여러분이 마케터라면, AI에게 “우리 회사 블로그 콘텐츠는 항상 이런 톤으로, 이런 구조로 써라”는 규칙을 SKILL.md 파일 하나에 적어두기만 하면 됩니다. 그러면 이후 모든 작업에서 AI가 그 전문성을 자동으로 적용합니다. 개발자에게는 코드 리뷰·라이선스 헤더·SQL 검증 등의 반복 업무를 표준화해주고, 비개발자에게는 번역 스타일, 보고서 포맷, SNS 카피 작성 규칙 등을 에이전트에 영구 장착시켜주는 강력한 기능입니다.
💡 왜 Skills가 특별한가? MCP(Model Context Protocol) 서버처럼 복잡한 인프라 설치 없이, 텍스트 파일 하나(SKILL.md)만으로 에이전트 동작 방식을 완전히 커스터마이징할 수 있다는 점이 핵심입니다. Git으로 팀원과 공유하거나, 공개 GitHub에서 타인이 만든 Skills를 무료로 가져다 쓸 수도 있습니다.
📁 Skills의 핵심 구조 — SKILL.md 파일 해부
Skills의 가장 아름다운 점은 구조가 단순하다는 것입니다. 하나의 Skill은 아래 폴더 구조로 이루어집니다.
my-skill/ SKILL.md # (필수) 메타데이터와 지시사항 scripts/ # (선택) Python·Bash 스크립트 references/ # (선택) 문서, 템플릿, 가이드라인 assets/ # (선택) 이미지·로고 등 정적 파일
이 중에서 절대적으로 필요한 파일은 SKILL.md 하나입니다. 나머지는 모두 선택 사항입니다. SKILL.md의 구조는 두 부분으로 구성됩니다. 첫 번째는 YAML 형식의 헤더로, 에이전트가 이 Skill을 “언제” 사용할지 판단하는 기준이 됩니다. 두 번째는 자유 형식의 본문으로, 에이전트에게 “어떻게” 행동하라고 지시하는 내용입니다.
--- name: sns-copywriter description: Use when writing SNS captions, ad copy, or promotional content. Applies brand tone guidelines. --- # SNS 카피라이팅 Skill ## 톤 가이드라인 - 친근하고 간결하게, 문장 끝에 이모지 1개 필수 - 해시태그는 항상 3개 이하 - 경쟁사 언급 절대 금지
특히 description 필드가 매우 중요합니다. 에이전트는 이 설명을 읽고 “지금 이 Skill을 써야 하는 상황인가?”를 스스로 판단합니다. 따라서 “언제(When)” “무엇을 할 때(What)” 쓰는지를 구체적으로 써주는 것이 Skill의 자동 발동률을 크게 높이는 핵심 노하우입니다. 저는 description에 “Use when…”으로 시작하는 문장을 쓰는 것을 강력히 권장합니다.
Skills 저장 위치 — 전역 vs 워크스페이스
| 구분 | 저장 경로 | 사용 범위 |
|---|---|---|
| 전역(Global) | ~/.gemini/antigravity/skills/ | 모든 프로젝트에서 사용 가능 |
| 워크스페이스 | <project>/.agents/skills/ | 해당 프로젝트에서만 사용 |
🛠️ 비개발자도 따라 하는 첫 번째 Skill 만들기
구글 안티그래비티 Skills 기능의 가장 큰 오해는 “개발자만 쓸 수 있다”는 것입니다. 전혀 그렇지 않습니다. SKILL.md는 사실상 우리가 매일 쓰는 메모장 수준의 텍스트 파일입니다. 코드가 단 한 줄도 없어도 만들 수 있습니다. 아래 단계를 차례로 따라 해보세요.
📌 STEP 1 — 안티그래비티 설치 및 Google 계정 연동
공식 사이트 antigravity.google/download에서 설치 파일을 내려받고 실행합니다. macOS·Windows·Linux 모두 지원합니다. 설치 후 Google 계정으로 로그인하면 됩니다. 현재 구글 AI Pro(월 $20) 구독자 또는 무료 할당량 내에서 사용할 수 있습니다.
📌 STEP 2 — Skills 폴더 생성 (전역 설치)
터미널(또는 안티그래비티 내장 터미널)에서 아래 명령을 실행합니다. 터미널이 낯설다면 Finder(맥) 또는 파일 탐색기(윈도우)에서 해당 경로의 폴더를 직접 만들어도 됩니다.
mkdir -p ~/.gemini/antigravity/skills/my-first-skill
📌 STEP 3 — SKILL.md 파일 작성 (예: 블로그 글쓰기 전문가)
생성한 폴더 안에 SKILL.md 파일을 만들고 아래 내용을 붙여넣기 합니다. 메모장이나 VS Code 어느 것으로 편집해도 됩니다.
--- name: korean-blog-writer description: Use when writing Korean blog posts, articles, or any long-form content in Korean. --- # 한국어 블로그 글쓰기 Skill ## 필수 규칙 - 항상 존댓말 (습니다/해요 체) 사용 - 도입부에 독자의 고민을 공감하는 문장으로 시작 - 소제목은 호기심을 자극하는 질문 형식으로 - 글 말미에 핵심 요약 3줄 포함 - 어려운 영문 용어는 반드시 한국어 설명 병기
📌 STEP 4 — 안티그래비티에서 Skill 적용 확인
안티그래비티를 재시작하면 Skill이 자동으로 인식됩니다. 이제 에이전트 패널(Cmd+L)에서 “블로그 글 써줘”라고 입력하면 에이전트가 스스로 korean-blog-writer Skill을 감지하고 그 규칙에 따라 글을 작성합니다.
🎯 실전 Skill 5가지 — 지금 바로 쓸 수 있는 템플릿
구글 공식 GitHub(rominirani/antigravity-skills)에는 이미 수십 개의 공개 Skill이 있습니다. 하지만 실제로 한국 환경에서 바로 쓸 수 있는, 그리고 비개발자에게 실질적으로 유용한 5가지를 아래에 정리했습니다.
Skill #1
git-commit-formatter — 커밋 메시지 자동 표준화
깃(Git)을 처음 쓰는 분들의 가장 큰 고민 중 하나가 커밋 메시지입니다. “wip”, “수정”, “fix bug” 같은 의미 없는 메시지 대신 Conventional Commits 규격(feat: 로그인 기능 추가)으로 자동 포맷팅해주는 Skill입니다. SKILL.md만 있으면 별도 스크립트 없이 작동하므로, 비개발자도 커밋 전 “커밋 메시지 써줘”라고만 하면 됩니다.
Skill #2
license-header-adder — 저작권 헤더 자동 삽입
새 파일을 만들 때마다 회사 저작권 문구를 수동으로 붙여넣지 않아도 됩니다. references/HEADER.txt에 저작권 문구를 저장해두면, 에이전트가 새 파일 생성 시 자동으로 해당 헤더를 언어 형식에 맞게(Python은 # 주석, Java는 /* */ 형식) 삽입합니다. 이 Skill의 진가는 팀 전체가 같은 전역 Skill을 공유할 때 극대화됩니다.
Skill #3
code-review — AI 코드 리뷰어 장착
“이 코드 틀린 곳 없어?” 같은 막연한 요청 대신, 정확히 어떤 기준으로 리뷰할지를 SKILL.md에 체크리스트로 정의합니다. 버그 여부·엣지케이스 처리·스타일 가이드 준수·성능 이슈 등을 항목별로 점검하도록 지시하면, 에이전트가 팀 내 시니어 개발자 수준의 코드 리뷰를 자동 수행합니다. references/ 폴더에 회사 코딩 스타일 가이드 문서를 추가하면 더욱 정확해집니다.
Skill #4
json-to-pydantic — API 응답 자동 모델 변환
외부 API에서 받은 JSON 데이터를 Python Pydantic 모델로 변환하는 반복 작업을 자동화합니다. examples/ 폴더에 입력 JSON과 출력 Python 파일을 예시로 놓아두면, AI가 “이런 패턴으로 변환하면 되는구나”를 학습하여 새로운 JSON도 동일 패턴으로 처리합니다. 이처럼 Skill에 예시(Few-shot)를 포함하는 방식은 결과물의 일관성을 극적으로 높이는 기법입니다.
Skill #5
SNS 자동화 Skill — 마케터를 위한 비개발자 특화
콘텐츠 하나를 인스타그램·스레드·네이버 블로그·링크드인용으로 각각 다른 톤과 형식으로 재가공하는 반복 업무를 Skill로 표준화할 수 있습니다. 예를 들어 references/brand-tone.md에 브랜드 보이스 가이드를 넣고, SKILL.md에 “인스타는 이모지 많이, 링크드인은 전문적 어조”라고 지시하면 됩니다. 실제로 2026년 3월 현재 SNS 자동화 스터디가 진행 중일 만큼 비개발자들 사이에서 가장 뜨거운 활용 사례입니다.
⚖️ Skills vs Workflows vs Rules — 뭐가 다른가?
안티그래비티를 처음 쓰면 Skills, Workflows, Rules 세 개념이 뒤섞여 혼란스럽습니다. 이 세 가지는 모두 에이전트의 동작을 커스터마이징하는 기능이지만, 적용 범위와 목적이 완전히 다릅니다.
| 구분 | 역할 | 저장 위치 | 활용 예시 |
|---|---|---|---|
| Skills | 특정 도메인 전문성 부여, 복잡한 멀티스텝 작업 정의 | .agents/skills/ | 코드 리뷰, SNS 카피 작성, DB 검증 |
| Workflows | 반복 실행 가능한 단계별 절차 정의 (슬래시 명령으로 호출) | .agents/workflows/ | /unit-test-generate, /deploy-check |
| Rules | 모든 작업에 항상 적용되는 전역 행동 원칙 | .agents/rules/ | PEP8 준수, 한국어 출력 유지, 주석 항상 추가 |
개인적인 의견을 덧붙이자면, Rules는 항상 켜져 있는 ‘헌법’이고, Skills는 필요할 때 꺼내 쓰는 ‘전문서’이며, Workflows는 정기적으로 실행하는 ‘업무 매뉴얼’이라고 생각하면 가장 직관적입니다. 세 가지를 조합해서 쓰면 안티그래비티를 진정한 나만의 AI 팀장으로 만들 수 있습니다. Rules에는 출력 언어와 코드 스타일을, Skills에는 도메인별 전문성을, Workflows에는 배포·테스트 같은 반복 루틴을 담으세요.
⚡ 빠른 팁: 안티그래비티 에이전트 패널에서 /를 입력하면 등록된 Workflows 목록이 자동 완성됩니다. @를 입력하면 파일·MCP 서버·Skill 등을 컨텍스트로 참조할 수 있습니다.
📊 2026년 3월 최신 업데이트 — 사용량 제한의 진실
구글 안티그래비티는 현재 완전 무료로 시작할 수 있지만, 사용량 제한 정책이 2026년 들어 계속 변경되고 있어 정확히 파악해두는 것이 중요합니다. 2026년 3월 12일 공식 발표 기준으로 정리하면 다음과 같습니다.
| 요금제 | 월 비용 | 사용 가능 모델 | 특이사항 |
|---|---|---|---|
| 무료(Free) | $0 | Gemini Pro(제한) | 5시간마다 할당량 초기화 |
| Google AI Pro | $20/월 | Gemini 3.1 Pro 등 | 주간 한도 적용 (3월 12일 축소) |
| Google AI Ultra | $200/월 | Gemini 3 Ultra 등 전체 | 주간 한도 있으나 가장 여유로움 |
⚠️ 주의 (2026년 3월 12일 변경사항): 구글 AI Pro 요금제 사용자의 경우, 기존 매일 5시간마다 초기화되던 할당량과 별개로 주간 최대 한도(baseline quota)가 소급 적용되었습니다. 즉, 열심히 쓰다 보면 일일 할당량이 남아 있어도 주간 한도에 걸릴 수 있습니다. 구글은 이를 “Pro는 Gemini Pro를 체험하는 요금제”로 위상을 조정했습니다. 실무에서 안티그래비티를 집중적으로 쓴다면 AI Ultra($200/월)가 현실적인 선택입니다.
Skills 기능 자체는 어떤 요금제에서도 동일하게 작동합니다. 사용량 제한은 Skills의 수나 복잡도와 무관하게, AI가 토큰을 얼마나 소비하느냐에 달려 있습니다. 따라서 Skills를 잘 설계해서 에이전트가 한 번의 작업으로 더 많은 일을 처리하도록 만드는 것이 사용량을 아끼는 가장 효율적인 방법이기도 합니다.
❓ Q&A — 자주 묻는 질문 5가지
✍️ 마치며 — 총평
구글 안티그래비티 Skills는 단순히 개발자를 위한 기능이 아닙니다. 오히려 저는 이 기능이 비개발자들에게 더 큰 가치를 줄 수 있다고 생각합니다. 코딩을 배우지 않아도, 자신이 매일 반복하는 업무의 규칙을 텍스트로 정리할 수 있다면 — 그것으로 충분히 나만의 전문 AI 에이전트를 만들 수 있습니다.
물론 2026년 3월 현재 사용량 제한 정책이 계속 조이고 있고, 특히 Pro 요금제 사용자들 사이에서 불만이 나오고 있는 것은 분명한 단점입니다. 그러나 무료 할당량 내에서도 Skills를 활용한 자동화 작업은 충분히 가능하고, 전체 무료 코딩 에이전트 도구 중에서 이만한 완성도를 가진 제품은 현재 없습니다. Skills를 통해 에이전트를 ‘내 업무 방식으로 훈련’시키는 경험은, 단순히 “AI에게 지시하는” 것과 근본적으로 다른 생산성을 만들어냅니다.
📌 핵심 요약 3줄
- 구글 안티그래비티 Skills = SKILL.md 텍스트 파일 하나로 에이전트에 전문성 장착, 코딩 불필요
- Skills(전문성) + Workflows(반복 루틴) + Rules(전역 원칙) 조합이 안티그래비티 최강 활용법
- 2026년 3월 12일 Pro 요금제 주간 한도 축소됐지만, 무료 사용 범위 내에서도 Skills 활용 가능
※ 본 게시물은 2026년 3월 14일 기준으로 작성된 정보이며, 구글 안티그래비티(Google Antigravity)의 정책·기능·사용량 제한은 Google의 결정에 따라 예고 없이 변경될 수 있습니다. 최신 정보는 공식 사이트(antigravity.google)에서 반드시 확인하시기 바랍니다.
댓글 남기기