Antigravity 스킬이란 무엇인가요?
Antigravity 스킬은 에이전트 작업에 필요한 반복 지침을 묶는 방법입니다. 매번 같은 설정 설명을 프롬프트에 붙이는 대신 이름이 있는 스킬에 집중된 작업 흐름을 저장하면, 설명과 작업이 맞을 때 에이전트가 이를 찾을 수 있습니다. 좋은 스킬은 거대한 규칙집이 아니라 적용 시점, 읽어야 할 자료, 실행 순서와 완료 기준을 설명하는 작고 테스트 가능한 단위입니다.
능력과 권한을 구분하는 것이 중요합니다. 스킬은 sitemap 감사, 릴리스 점검, 컴포넌트 준비 방법을 알려 줄 수 있지만 모든 명령을 자동으로 안전하게 만들지는 않습니다. 셸, 네트워크, 비밀 값, 파일 삭제, 패키지 설치, MCP 도구에는 여전히 승인이 필요할 수 있습니다. 지침의 경계를 명시해 편의 기능이 조용한 자동화로 바뀌지 않게 하세요.
Antigravity 스킬 검색에는 GitHub 모음, 설치 방법, Rules와의 비교도 포함됩니다. 서로 관련은 있지만 같은 의도는 아닙니다. 이 페이지는 빈 폴더에서 검증된 스킬까지의 실용적인 과정을 다루고, 플러그인·CLI·MCP·권한 질문은 더 적합한 안내서로 연결합니다.
Antigravity 스킬은 어디에 두나요?
정확한 위치는 한 프로젝트에서만 사용할지 사용자 계정 전체에서 사용할지에 따라 달라집니다. 사용하는 제품 화면의 최신 공식 문서를 따르고, 발견 문제를 조사하기 전에 활성 작업 공간과 계정을 확인하세요. 유효한 SKILL.md를 만들었지만 현재 에이전트 세션이 검색하지 않는 폴더에 넣는 실수가 자주 발생합니다.
저장소 스크립트, 로컬 규칙, 특정 배포 절차에 의존한다면 프로젝트 범위부터 사용하세요. 여러 저장소에서 공유할 일반적인 작업 흐름이라면 사용자 범위를 선택할 수 있습니다. 프로젝트 전용 경로나 비밀 값을 사용자 전체 스킬에 넣지 말고, 민감한 저장소에 커뮤니티 스킬을 복사하기 전에 참조된 파일을 모두 읽으세요.
| 범위 | 일반적인 위치 | 적합한 용도 | 첫 확인 |
|---|---|---|---|
| 프로젝트 | .agents/skills/<skill-name>/ | 저장소 전용 작업 흐름, 스크립트와 규칙 | 스킬을 소유한 작업 공간을 열고 현재 브랜치를 확인합니다. |
| 사용자 | 설정된 사용자 스킬 디렉터리 | 여러 개인 프로젝트에서 공유하는 작업 흐름 | 로그인 프로필과 현재 릴리스에 문서화된 사용자 경로를 확인합니다. |
| 참고 파일 | 스킬 아래의 references/, scripts/, assets/ | 긴 체크리스트, 보조 스크립트, 예제와 추가 자료 | 헬퍼를 실행하기 전에 스킬 지침을 읽습니다. |
| 외부 모음 | 검토한 Git 저장소 또는 공식 카탈로그 | 기본 제공 기능으로 오해하지 않고 커뮤니티 작업 흐름을 찾기 | 게시자, 라이선스, 커밋, 의존성과 요청 권한을 확인합니다. |
SKILL.md로 Antigravity 스킬 만들기
처음에는 가장 작은 유용한 스킬을 만드세요. 정적 사이트 릴리스 확인, 마이그레이션 검토, 테스트 계획 준비처럼 한 가지 작업을 선택합니다. 폴더에는 안정적인 소문자 이름을 사용하고, 무엇을 하며 언제 선택해야 하는지 알려 주는 짧은 설명을 작성합니다. 설명이 모호하면 발견되지 않을 수 있고, 너무 넓으면 처리할 수 없는 작업에 선택될 수 있습니다.
주 파일은 읽기 쉽게 유지하세요. 작업 흐름, 제약, 필요한 증거, 중단 조건은 SKILL.md에 넣습니다. 긴 예제나 세부 참고 자료는 하위 파일로 옮기고 언제 읽어야 하는지 적습니다. 스킬이 명령을 실행한다면 명령, 예상 출력, 결과가 다를 때의 대응을 함께 기록하세요.
- 한 가지 작업 선택기술 스택의 모든 도구가 아니라 스킬이 도와주는 사용자 결정을 작성합니다.
- 폴더 만들기테스트하려는 프로젝트 또는 사용자 범위에 안정적인 이름의 폴더를 만듭니다.
- frontmatter 작성발견이 작업과 자연스럽게 맞도록 이름과 설명을 명확히 적습니다.
- 작업 흐름 추가입력, 순서, 증거, 보안 경계, 완료 기준을 나열합니다.
- 작은 작업으로 테스트먼저 읽기 전용 점검이나 시뮬레이션을 요청하고 결과를 확인한 후 쓰기를 허용합니다.
name: sitemap-release-check; description: 정적 sitemap을 확인하고 HTML과 UTF-8 검증 결과를 변경 전에 보고합니다.이 예제는 구조를 보여 주는 참고입니다. 모든 릴리스가 같은 폴더 이름이나 명령을 사용하는 것은 아니므로 게시 전에 최신 Google 문서와 저장소 규칙에 맞게 조정하세요.
에이전트가 스킬을 사용하는 방법
발견은 보통 스킬 이름과 설명에서 시작합니다. 작업이 일치해 보이면 에이전트는 기본 지침을 읽고 현재 작업에 필요한 참고 자료만 불러와야 합니다. 이런 점진적 공개 방식은 처음의 맥락을 작게 유지하고 어떤 세부 사항이 답변에 영향을 줬는지 확인하기 쉽게 합니다. 신뢰하기 전에 스킬 파일을 직접 읽어 보는 자연스러운 검토 지점도 만들어 줍니다.
유용한 스킬은 자신의 한계를 설명합니다. 읽기 전용인지, 어떤 디렉터리가 범위인지, 안전한 명령은 무엇인지, 확인이 필요한 작업은 무엇인지, 어떤 증거를 저장해야 하는지 적으세요. 저장소를 바꾸는 작업이라면 마지막 diff 검토와 깨끗한 Git 상태를 요구하세요. 외부 서비스를 사용한다면 공식 엔드포인트나 출처를 명시하고 조용히 미러로 바꾸지 마세요.
첫 실행은 지루할 정도로 예측 가능해야 합니다. 파일 목록을 만들거나 계획을 설명하거나 안전한 fixture를 확인하게 하세요. 예상 밖 명령, 설명 없는 네트워크 요청, 토큰 요구는 권한을 넓힐 신호가 아니라 중단 신호입니다.
맞추기
작업의 표현과 설명이 같은 종류의 작업 흐름을 가리킵니다.
읽기
에이전트는 기본 지침과 현재 작업에 필요한 참고 자료만 읽습니다.
계획하기
스킬은 행동 전에 가정, 쓰기 범위, 명령, 중단 조건을 공개합니다.
검증하기
결과에는 파일, URL, 테스트 출력과 같은 구체적인 증거가 포함됩니다.
검토하기
일상적인 사용 전에 diff, 권한, 외부 영향을 확인합니다.
스킬·Rules·플러그인·MCP의 차이
‘Antigravity 맞춤 설정’이라는 말에는 여러 표면이 포함됩니다. 스킬은 반복 작업 절차, Rule은 여러 작업에 지속적으로 적용할 지침, 플러그인이나 확장 기능은 제품 통합과 기능, MCP는 도구나 데이터 연결에 사용하세요. 함께 사용할 수는 있지만 서로 바꿔 쓸 수 있는 개념은 아닙니다.
Antigravity 규칙은 향후 별도 페이지로 연구할 가치가 있지만, antigravity plugins는 이미 사이트의 Extensions 안내서와 연결됩니다. 여기서는 파일에 무엇을 넣을지 결정하고 적절한 기존 안내서로 연결하는 정도로 비교하며, MCP나 CLI 전체 튜토리얼을 중복하지 않습니다.
| 표면 | 주요 역할 | 사용할 때 |
|---|---|---|
| 스킬 | 입력, 단계, 참고 자료와 검증을 포함한 반복 작업 흐름을 가르침 | 작업의 시작, 끝, 증거 흐름이 분명할 때 |
| Rule | 지속적인 선호, 제약 또는 프로젝트 지침을 범위 안에 유지함 | 서로 다른 많은 작업에 같은 지침을 적용해야 할 때 |
| 플러그인 또는 확장 | 호스트 통합, 명령 표면, 언어 기능 또는 UI 기능을 추가함 | 문서화된 절차가 아니라 제품 통합이 필요할 때 |
| MCP 서버 | 로컬 또는 원격 서비스의 도구와 리소스를 노출함 | 스킬 텍스트 밖의 데이터나 작업에 통제된 경계가 필요할 때 |
커뮤니티 스킬을 안전하게 설치하고 검증하기
GitHub 모음이 유용할 수 있지만 검색 결과 자체는 신뢰의 근거가 아닙니다. 스킬을 복사하기 전에 저장소 기록, 라이선스, 참조된 스크립트, 패키지 파일, 네트워크 호출과 필요한 자격 증명을 확인하세요. SKILL.md 전체와 연결된 참고·스크립트 파일을 모두 읽습니다. 짧은 스킬도 세부 내용을 보지 않으면 파괴적인 명령을 요청할 수 있습니다.
설치 후에는 의도한 작업을 재현하는 가장 작은 작업 공간에서 발견을 확인하세요. 읽기 전용 요청으로 시작하고 어떤 스킬을 왜 선택했는지 설명하게 합니다. 예상 파일과 실제 diff를 비교하세요. CLI, 플러그인 또는 MCP 서버에 의존하는 스킬이라면 해당 의존성을 별도로 테스트해 발견 문제와 의존성 문제를 구분하세요.
- 출처 읽기게시자, 라이선스, 기록, 참고 자료, 스크립트, 의존성과 외부 엔드포인트를 확인합니다.
- 테스트 범위에 복사사용자 전체에 적용하기 전에 임시 저장소나 프로젝트 폴더에서 테스트합니다.
- 읽기 전용 프롬프트 실행수정이나 셸 동작을 허용하기 전에 목록, 설명 또는 시뮬레이션을 요청합니다.
- 증거 확인선택된 스킬, 읽은 파일, 제안된 명령과 출력이 의도와 맞는지 확인합니다.
- 신중하게 확장작업 흐름이 예측 가능하고 권한이 문서화된 뒤에만 더 넓게 공유합니다.
- API 키, 브라우저 세션 데이터, 운영 자격 증명을 스킬 파일에 넣지 마세요.
- 삭제, 배포, 결제, 메시지 전송, 계정 관리 작업은 수동 검토 뒤에 실행하세요.
- 스킬이 스크립트, 패키지 관리자 또는 외부 서비스를 호출한다면 의존성을 고정하거나 검토하세요.
- 생성된 변경을 확인하고 되돌릴 수 있도록 버전 관리를 사용하세요.
- 설명되지 않은 네트워크 요청은 멈추고 조사해야 할 신호로 취급하세요.
버전과 공식 출처 확인
이 프로젝트는 소프트웨어 다운로드 사이트이므로 가이드를 게시하기 전에 버전 최신성 확인을 완료했습니다. 2026년 8월 19일 공식 Antigravity 문서와 다운로드 흐름에서 현재 제품 라인을 확인했습니다. 사이트에 기록된 데스크톱 제품은 Antigravity 2.0 v2.8.1과 Antigravity IDE v2.5.5이고, CLI 가이드는 v1.1.14로 동기화했습니다. 스킬 동작은 설치 프로그램 버전과 별도로 바뀔 수 있으므로 최종 기준은 공식 Skills 문서로 삼으세요.
다운로드 CTA는 공식 페이지를 가리키는 fallback으로 유지합니다. 영구 바이너리 URL, 패키지 크기, checksum, 안전성 검사 결과를 이 페이지에서 만들어 내지 않습니다. 과거 v1.13.3과 v2.2.1 페이지는 기록 보관용이며 현재 릴리스로 표현하지 않습니다.
Antigravity 스킬 자주 묻는 질문
Antigravity 스킬이란 무엇인가요?
보통 SKILL.md 파일을 중심으로 정리한 재사용 가능한 지침 모음으로, 에이전트가 전문 작업 흐름을 일관되게 수행하도록 돕습니다. 절차를 알려 주지만 모든 명령을 실행할 권한을 자동으로 부여하지는 않습니다.
Antigravity에 스킬을 어떻게 추가하나요?
현재 Antigravity 릴리스가 설명하는 프로젝트 또는 사용자 범위에 이름이 있는 스킬 폴더를 만들거나 복사합니다. 읽을 수 있는 SKILL.md가 있는지 확인하고 작은 작업 공간에서 읽기 전용 요청으로 발견을 테스트한 후 수정 권한을 허용하세요.
SKILL.md는 어떻게 만드나요?
범위가 좁은 작업 하나를 정하고 안정적인 폴더를 만든 다음 frontmatter에 이름과 설명을 추가합니다. 입력, 단계, 참고 자료, 보안 경계, 완료 기준을 기록하고 긴 내용은 references나 scripts로 옮겨 언제 읽을지 설명하세요.
Antigravity에서 Claude Skills를 사용할 수 있나요?
다른 에이전트 제품용 스킬이 즉시 호환된다고 가정하지 마세요. 폴더 구조, frontmatter, 명령, 경로, 권한 가정을 검토하고 Antigravity에 맞게 수정한 뒤 기본 제공 흐름처럼 사용하기 전에 테스트하세요.
Antigravity 스킬과 Rules의 차이는 무엇인가요?
스킬은 보통 특정 작업에 적용되는 절차이고 Rule은 여러 작업에 지속적으로 영향을 주는 지침이나 제약입니다. 반복 체크리스트라면 스킬부터 만들고, 항상 유지할 선호라면 최신 Rules 형식을 확인하세요.
Antigravity 스킬은 안전한가요?
스킬 파일이 자동으로 안전하거나 공식적인 것은 아닙니다. 출처와 참조 스크립트를 읽고 임시 또는 위험이 낮은 프로젝트에서 테스트하며 비밀 값을 파일에서 제외하고 삭제·네트워크·자격 증명·배포·계정 작업은 검토를 거치세요.
GitHub에서 Antigravity 스킬은 어디서 찾나요?
게시자, 라이선스, 기록, 파일, 의존성과 요청 권한을 확인할 수 있는 저장소나 모음을 찾으세요. GitHub는 발견을 위한 출처이지 유지 관리나 안전성을 보증하는 표시는 아닙니다.
스킬이 플러그인, CLI 명령 또는 MCP 서버를 대신하나요?
아닙니다. 스킬은 작업 흐름을 설명하고, 플러그인과 확장 기능은 호스트 통합을 추가하며, CLI 명령은 터미널 작업을 제공하고 MCP 서버는 도구나 리소스를 노출합니다. 실제로 필요한 경우에만 연결하세요.
공식 출처
- Google Antigravity Skills 문서 — 스킬 개념, 구조, 발견과 사용 방법에 대한 공식 안내입니다.
- Google Antigravity IDE Skills 문서 — IDE 전용 스킬 동작과 현재 제품 용어를 확인합니다.
- Google Antigravity Rules 문서 — 작업 스킬이 아닌 지속적인 Rules를 조사할 때 사용하는 공식 출처입니다.
- Google Antigravity CLI 플러그인과 Skills — CLI에서 플러그인과 Skills를 구분하는 공식 범위입니다.
- Google Antigravity 다운로드 — 현재 플랫폼과 설치 파일을 확인하는 공식 다운로드 경로입니다.