Antigravity 스킬이 뭔데? 나만 몰래 쓰던 기능이 공식으로 풀렸다

여러분 이거 경험 있죠?

AI 코딩 도구 쓰다가 “아 이거 매번 설명하기 귀찮은데…” 하는 순간.

저도요.

매번 블로그 글 쓸 때마다 “코딩애플 스타일로 써줘”, “OREO 구조로 해줘”, “SNS 포스트도 만들어줘” 이거 일일이 말하는 게 얼마나 귀찮은지.

그래서 저는 강제로 스킬 폴더를 만들어서 쓰고 있었어요.

.claude/skills/ddd/SKILL.md 이런 식으로요.

근데 말이죠.

2026년 1월, 드디어 이 기능이 공식으로 들어왔습니다.

솔직히 처음 공식 문서 봤을 때 “아니 이게 된다고?” 했어요.

내가 몰래 쓰던 게 정식 기능이 된 거잖아요.

Skills가 뭔데? 3초 만에 이해하기

Google Antigravity Skills는 2026년 1월 공식 문서에서 발표된 기능으로, 에이전트의 능력을 확장하는 재사용 가능한 지식 패키지입니다.

스킬… 뭔 소린지 모르겠죠?

쉽게 말하면 이거예요.

AI한테 매뉴얼 주는 거.

“이 폴더에 있는 SKILL.md 파일 읽고, 거기 적힌 대로 해” 하고 지시하는 시스템이에요.

마치 신입사원한테 업무 매뉴얼 주는 것처럼요.

기존 방식 vs Skills 방식

❌ 기존 방식 (매번 설명):
"블로그 글 써줘. 근데 E-E-A-T 구조로 해줘. 
 OREO 패턴 적용하고. GEO 최적화도 하고.
 코딩애플 스타일로 해줘. 질문 후크 넣고...
 아 그리고 SNS 포스트도 만들어줘."
 
 → 매번 30줄씩 프롬프트 작성 😩

✅ Skills 방식:
"@blog-pipeline 써줘"

 → 끝. 스킬 파일이 알아서 다 처리 😎

진짜 이게 됩니다.

내가 1개월 동안 강제로 만들어 쓴 후기

🤔 왜 강제로 만들었나?

사실 저는 2025년 12월부터 이미 스킬 폴더를 만들어서 쓰고 있었어요.

공식 기능이 아니라 그냥 제가 해킹한 거죠.

Claude 에이전트가 특정 폴더 구조를 읽을 수 있다는 걸 발견하고, “어? 그러면 여기에 지시사항 넣어두면 되겠네?” 해서 시작한 거예요.

📁 실제로 만든 스킬들

제가 만든 스킬 목록이에요:

스킬 이름	용도	사용 빈도
`unified-blog-writer-markdown-eeat`	블로그 글 작성	매일
`crypto-analyzer`	BTC 시황 분석	주 3회
`sns-writer`	SNS 포스트 생성	매일
`coinalyze-scanner`	알트코인 스캐닝	주 2회
`telegram-sender`	텔레그램 전송	자동

솔직히 이거 없으면 못 살아요 지금.

매일 블로그 글 쓰는데, 프롬프트 작성 시간이 체감 80% 줄었어요.

📊 실제 시간 절약 데이터

블로그 글 1개 작성 기준:

❌ 스킬 없이:
- 프롬프트 작성: 10분
- AI 응답 확인 및 수정 요청: 15분
- SNS 포스트 별도 요청: 5분
- 총 30분

✅ 스킬 사용 후:
- "@blog-pipeline [주제]" 입력: 10초
- AI 응답 확인: 5분
- 총 5분 10초

→ 약 83% 시간 절약

근데 진짜 웃긴 게요, 이게 공식 기능이 아니었다는 거예요.

저 혼자 이렇게 쓰고 있었는데, 드디어 구글에서 공식으로 지원하기 시작한 거죠.

공식 Skills 기능 뜯어보기

📍 스킬 저장 위치

공식 문서에 따르면 스킬은 두 곳에 저장할 수 있어요:

1. 워크스페이스 전용 (프로젝트별):
   <workspace-root>/.agent/skills/<skill-folder>/

2. 전역 (모든 프로젝트 공통):
   ~/.gemini/antigravity/skills/<skill-folder>/

저는 지금 .claude/skills/ 폴더에 저장해서 쓰고 있는데요.

공식 경로로 옮기면 더 안정적으로 동작할 것 같아요.

📝 SKILL.md 파일 구조

스킬 파일 구조는 이래요:

---
name: my-awesome-skill
description: >
  이 스킬은 무엇을 하는지 한 줄로 설명.
  에이전트가 이 설명을 보고 스킬 사용 여부를 결정함.
---

# 스킬 제목

여기에 상세 지시사항 작성.
AI가 이 내용을 읽고 따름.

핵심은 description이에요.

에이전트가 대화 시작할 때 사용 가능한 스킬 목록을 확인하고, description을 보고 “아, 이 스킬이 지금 필요하겠다” 하고 판단해요.

그래서 description을 잘 써야 합니다.

🎯 Progressive Disclosure (점진적 공개)

이거 진짜 똑똑한 설계예요.

에이전트가 모든 스킬의 전체 내용을 다 읽지 않아요.

먼저 스킬 목록과 description만 확인
현재 작업에 관련 있는 스킬인지 판단
관련 있으면 그때 SKILL.md 전체 읽기

왜 이렇게 하냐?

컨텍스트 윈도우 절약 때문이에요.

스킬 20개 만들어놨는데 매번 다 읽으면 토큰 낭비잖아요.

필요한 것만 읽어서 효율적으로 처리하는 거예요.

내가 실제로 쓰는 스킬 예시

🍎 블로그 작성 스킬

제가 가장 많이 쓰는 스킬이에요.

---
name: unified-blog-writer-markdown-eeat
description: >
  테크/투자 블로그 글을 E-E-A-T + OREO + GEO 구조로 작성.
  웹 검색 필수, 사실 확인 필수, 경험 중심 콘텐츠.
  코딩애플 스타일 페르소나 적용.
---

# Unified Blog Writer (E-E-A-T + GEO Edition)

## 필수 실행 체크리스트
[ ] 웹 검색 완료
[ ] 팩트 체크 완료
[ ] GEO 최적화 확인
[ ] 경험 요소 확인
[ ] 페르소나 적용 확인
[ ] SNS 포스트 자동 생성
...

이 스킬 하나로 블로그 글 쓸 때 챙겨야 할 것들을 자동으로 체크해요.

웹 검색도 하고, 팩트 체크도 하고, SNS 포스트도 만들어주고.

📊 코인 분석 스킬

---
name: crypto-analyzer
description: >
  비트코인 및 알트코인 기술적 분석.
  29개 지표 + 28개 패턴 + 엘리엇 파동 분석.
---

이건 매일 BTC 시황 글 쓸 때 사용해요.

“@crypto-analyzer BTC” 이렇게만 치면 알아서 분석 시작해요.

강제 사용 → 공식 기능, 뭐가 달라졌나?

✅ 좋아진 점

안정성 향상
- 강제로 만들 때는 가끔 스킬을 못 읽는 경우가 있었어요
- 공식 기능이 되면서 더 안정적으로 동작
공식 경로 지원
- .agent/skills/ 또는 ~/.gemini/antigravity/skills/
- 공식 경로라서 향후 업데이트에도 호환될 듯
문서화
- 이제 공식 문서가 있으니까 다른 사람한테 설명하기 쉬움
- 커뮤니티에서 스킬 공유도 활발해질 듯

⚠️ 아쉬운 점

기존 스킬 마이그레이션 필요
- .claude/skills/ → .agent/skills/ 로 옮겨야 함
- 귀찮지만 어쩔 수 없음
스킬 마켓플레이스 아직 없음
- 다른 사람이 만든 스킬 쉽게 가져다 쓰는 기능 없음
- 이건 나중에 나오겠죠 뭐

스킬 만드는 팁 (1개월 삽질 경험)

1. Description은 구체적으로

❌ BAD:
description: 블로그 글 쓰기

✅ GOOD:
description: >
  테크/투자 블로그 글을 E-E-A-T + OREO + GEO 구조로 작성.
  웹 검색 필수, 사실 확인 필수, 경험 중심 콘텐츠.

description이 부실하면 에이전트가 언제 이 스킬을 써야 하는지 판단을 못해요.

2. 체크리스트 넣기

## 필수 실행 체크리스트
[ ] 1. 웹 검색 완료
[ ] 2. 팩트 체크 완료
[ ] 3. GEO 최적화 확인
...

체크리스트가 있으면 AI가 빠뜨리지 않고 하나씩 실행해요.

저도 처음엔 체크리스트 없이 썼는데, SNS 포스트 생성을 자꾸 빼먹더라고요.

체크리스트 넣고 나서 누락 0%.

3. 예시 넣기

❌ BAD:
"좋은 제목을 써줘"

✅ GOOD:
❌ BAD 예시: "Claude 4 완벽 가이드"
✅ GOOD 예시: "Claude 4 3개월 쓰고 솔직히 말합니다"

AI한테 “이렇게 하지 마” + “이렇게 해” 둘 다 보여주면 훨씬 잘 따라해요.

4. 저장 경로 명시

## 자동 저장 경로
- 테크 글: `2. 🛠 Areas/블로그_운영/ AI & LLM/YYMMDD [제목].md`
- 투자 글: `2. 🛠 Areas/재테크_트레이딩/YYMMDD [제목].md`

파일 저장 위치까지 스킬에 적어두면 일관되게 저장돼요.

앞으로 뭐가 될까?

🔮 예상 1: 스킬 마켓플레이스

GitHub처럼 스킬을 공유하는 플랫폼 생길 것 같아요.

“블로그 작성 스킬”, “코드 리뷰 스킬”, “API 문서 작성 스킬” 이런 것들을 원클릭으로 설치하는 거죠.

🔮 예상 2: 스킬 체이닝

스킬끼리 연결해서 파이프라인 만드는 거요.

@blog-pipeline
 → @unified-blog-writer (글 작성)
 → @sns-writer (SNS 생성)
 → @telegram-sender (텔레그램 전송)

저는 이미 이렇게 쓰고 있긴 한데, 공식적으로 지원하면 더 편해질 듯.

🔮 예상 3: 스킬 버전 관리

스킬도 버전 관리가 필요해요.

v3.7에서 v3.8로 올리면 뭐가 바뀌었는지 추적할 수 있으면 좋겠어요.

시작하는 법 (5분 컷)

Step 1: 폴더 만들기

mkdir -p ~/.gemini/antigravity/skills/my-first-skill

Step 2: SKILL.md 만들기

---
name: my-first-skill
description: >
  간단한 테스트 스킬입니다.
  "테스트"라고 하면 이 스킬이 동작합니다.
---

# My First Skill

사용자가 "테스트"라고 하면:
1. "테스트 성공!"이라고 응답
2. 현재 시간 알려주기

Step 3: 사용하기

Antigravity에서 “테스트 해줘” 라고 말하면 스킬이 동작해요.

끝.

마무리

솔직히 말하면요.

저는 1개월 전부터 강제로 스킬 만들어서 쓰고 있었어요.

공식 기능이 아니라 그냥 해킹한 거였는데, 이게 정식 기능으로 들어온 거예요.

기분이 묘해요.

“내가 먼저 발견했다” 같은 느낌?

그리고 동시에 “이제 더 많은 사람들이 쓰겠다” 하는 기대감도 있어요.

여러분도 한번 만들어보세요.

처음엔 귀찮을 수 있는데, 한번 만들어놓으면 진짜 시간 절약 됩니다.

저처럼 매일 반복 작업하는 사람이라면 필수예요.

궁금한 거 있으면 댓글 남겨주세요.

FAQ

Q1: 스킬 없이 그냥 프롬프트 잘 쓰면 되는 거 아니에요?

네, 맞아요. 근데 매번 똑같은 프롬프트 치는 게 귀찮잖아요. 스킬은 그 반복을 없애주는 거예요.

Q2: 스킬 파일 수정하면 바로 반영되나요?

네, 바로 반영돼요. Antigravity가 대화 시작할 때 스킬 폴더를 다시 스캔해요.

Q3: 스킬 개수 제한 있나요?

공식적으로 제한은 없는 것 같은데, 너무 많으면 컨텍스트 윈도우 낭비될 수 있어요. 20개 이내로 권장.

Q4: 다른 사람 스킬 가져다 쓸 수 있나요?

SKILL.md 파일 복사해서 스킬 폴더에 넣으면 돼요. 아직 공식 공유 플랫폼은 없어요.

Q5: Cursor나 VS Code에서도 되나요?

Antigravity 전용이에요. Cursor는 .cursorrules 파일 사용하고, VS Code Copilot은 별도 설정 필요해요.

참고 자료

🏷️ 태그: #안티그래비티 #Antigravity #Skills #AIcoding #구글 #Gemini #개발도구 #자동화