Agent Skills · 스크린샷 15단계

Antigravity Skills 튜토리얼: 에이전트 스킬 설치, 생성, 관리

Antigravity 스킬이 무엇인지, GitHub의 1,300개 이상 스킬 라이브러리를 명령 한 줄로 설치하는 방법, 직접 SKILL.md를 작성하는 방법, 스킬을 워크플로로 연결하는 방법까지 — 모든 단계를 실제 화면 녹화와 대조하며 검증했습니다.

30초 만에 보는 Antigravity 스킬

  • 스킬은 SKILL.md 파일 하나를 담은 폴더입니다(.agents/skills는 워크스페이스, 그 외는 전역 스킬 디렉터리). 에이전트는 처음에 이름과 설명만 읽고, 작업에 필요해지면 전체 지침을 불러옵니다.
  • 오픈소스 저장소 antigravity-awesome-skills에는 1,300개 이상의 완성된 스킬이 있으며, npx antigravity-awesome-skills 한 줄로 스킬 폴더에 설치됩니다.
  • 직접 만드는 스킬은 폴더 + name/description 프론트매터가 있는 SKILL.md가 기본입니다. 결정적 검증이 필요하면 scripts/ 하위 폴더에 Python이나 셸 스크립트를 넣으세요.
  • 번들은 역할에 맞는 스킬을 알려주고, 워크플로는 사용 순서를 정해 줍니다 — Ship a SaaS MVP 워크플로는 브레인스토밍부터 보안 검토까지 이어서 실행됩니다.

Antigravity Skills Kit: Use 1,239+ Agent Skills in One Command

채널:AI Stack Engineer9:13

YouTube에서 보기

How to Create Agent Skills in Google Antigravity (2026)

채널:The Code City5:21

YouTube에서 보기

Intro to Agent Skills

채널:Google Antigravity4:06

YouTube에서 보기

아래 모든 단계는 이 녹화들을 프레임 단위로 대조하며 작성했습니다. 스크린샷의 타임스탬프는 영상의 해당 장면으로 바로 이동합니다. SKILL.md 프론트매터와 스킬 폴더에 관한 사실은 Google 공식 영상(Intro to Agent Skills)과도 교차 확인했습니다.

스크린샷은 위에 표기한 크리에이터들의 공개 녹화에서 가져왔으며, 본문 가이드는 이 사이트의 자체 저작물입니다. 영상 출처: AI Stack Engineer(저장소와 공식 문서), The Code City(IDE에서 스킬 생성).

Antigravity 스킬 설치·생성·관리 전 과정

Antigravity 스킬 이해하기

  1. 1

    스킬의 정체: name과 description을 가진 SKILL.md

    스킬은 SKILL.md 파일을 담은 폴더입니다. 프론트매터에는 이름과 설명이 들어가고, 본문에는 지침, 베스트 프랙티스, 선택적 스크립트가 들어갑니다. 대화가 시작되면 Antigravity는 각 스킬의 이름과 설명만 보고, 작업이 일치할 때 전체 파일을 읽습니다 — 그래서 스킬은 전문 지식을 더하면서도 컨텍스트를 상시 소모하지 않습니다.

    Google Antigravity docs Agent Skills page explaining what Antigravity skills are, with the Instructions, Best practices and Optional scripts bullets that make up every skill package
    공식 문서가 스킬 패키지의 세 가지 구성 요소를 정의합니다.1:15부터 보기
  2. 2

    스킬의 위치 정하기: 워크스페이스 또는 전역

    Antigravity는 두 가지 범위를 지원합니다. 워크스페이스 스킬은 프로젝트의 .agents/skills 폴더에 두며 배포 절차, 테스트 규칙 같은 팀 컨벤션에 적합합니다. 전역 스킬은 모든 프로젝트에서 동작하며 개인 유틸리티에 어울립니다. 문서에 따르면 현재 기본값은 .agents/skills이고, 하위 호환을 위해 .agent/skills도 유지됩니다.

    Antigravity Where skills live docs table comparing workspace-specific and global skill folders, with the note that Antigravity now defaults to .agents/skills and keeps .agent/skills for backward compatibility
    두 범위, 하나의 규칙: 스킬이 어디까지 적용될지에 따라 폴더를 고릅니다.1:18부터 보기

GitHub에서 스킬 라이브러리 설치하기

  1. 3

    GitHub에서 antigravity-awesome-skills 라이브러리 열기

    가장 큰 커뮤니티 컬렉션은 antigravity-awesome-skills 저장소입니다. 계획, 코딩, 테스트, 보안, 제품 작업을 위한 1,300개 이상의 완성된 스킬이 Claude Code, Gemini CLI, Cursor, Copilot, Antigravity 등 주요 에이전트를 지원합니다. 설치 전에 README와 카탈로그를 먼저 훑어보세요.

    GitHub landing page of the Antigravity Awesome Skills repository listing 1,328+ agentic skills for Claude Code, Gemini CLI, Cursor, Copilot and more, with contributor and language stats in the About sidebar
    저장소 랜딩 페이지에서 컬렉션 규모와 현재 버전을 확인할 수 있습니다.8:50부터 보기
  2. 4

    npx 명령 한 줄로 라이브러리 설치

    터미널에서 npx antigravity-awesome-skills를 실행합니다. 인스톨러는 SKILL.md 파일들을 스킬 폴더(기본값은 Antigravity의 전역 스킬 경로)에 넣습니다. --cursor, --claude, --codex, --gemini, --agents 등의 플래그로 다른 도구에 설치할 수 있고, --path는 사용자 지정 디렉터리를, --help는 전체 옵션을 보여 줍니다.

    Terminal output of npx antigravity-awesome-skills showing the --cursor, --claude, --antigravity and --agents install flags that drop SKILL.md files into each tool's skills folder
    인스톨러는 지원하는 에이전트와 IDE마다 플래그를 하나씩 나열합니다.2:10부터 보기
  3. 5

    1,300개 스킬을 넘기지 말고 스타터 번들부터 고르기

    저장소의 bundles.md는 역할별로 스킬을 큐레이션합니다. Web Wizard는 React 패턴, Tailwind, 프런트엔드 디자인에 집중하고, Hacker Pack은 침투 테스트 방법론과 취약점 스캐닝, Product Pack은 브레인스토밍·기획·SEO를, Essentials는 클린코드·기획·검증 기본기를 담습니다. 번들은 본질적으로 읽기 목록이며, 설치된 스킬 중 내 작업에 해당하는 것을 알려 줍니다.

    Antigravity Skill Bundles README with the Quick Start section showing the npx install and git clone commands that add curated starter-pack skills into the .agent/skills workspace folder
    퀵스타트: 저장소는 한 번만 설치하고, 역할에 맞는 번들을 따라갑니다.2:35부터 보기
  4. 6

    실행 전에 공식 출처와 신뢰 등급 확인하기

    모든 스킬이 같은 신뢰 수준은 아닙니다. 공식(Official) 스킬은 Anthropic, Google, OpenAI, Vercel, Supabase 같은 벤더가 직접 제공합니다. 커뮤니티 기여는 safe(읽기 전용 또는 기획용)와 위험(시스템 변경, 보안 테스트 실행)으로 분류됩니다. 전부 MIT 라이선스로 읽을 수 있으니, 에이전트에게 사용하게 하기 전에 SKILL.md를 열어 무엇을 하는 스킬인지 확인하세요.

    Official Sources section of the Antigravity skills catalog crediting the anthropics/skills, google/skills, OpenAI Codex and Vercel skill collections that feed the library
    README에는 이 라이브러리의 기반이 되는 공식 컬렉션이 명시되어 있습니다.4:52부터 보기

IDE에서 직접 스킬 만들기

  1. 7

    프로젝트에 .agents/skills 폴더 만들기

    Antigravity Explorer에서 프로젝트 루트를 우클릭하고 New Folder를 선택합니다. .agents를 만들고 그 안에 skills, 그다음 스킬마다 폴더를 하나씩 만듭니다(예: code-reviewer, deployer, sql-reviewer). 여기에 둔 워크스페이스 스킬은 이 프로젝트의 에이전트가 자동으로 인식합니다.

    Antigravity Explorer right-click New Folder menu being used to create the .agents/skills directory inside a project before adding custom agent skills
    우클릭 → New Folder면 스킬 트리를 시작하기에 충분합니다.0:58부터 보기
  2. 8

    공식 2단계 규칙 따르기

    Google 공식 문서는 의도적으로 단순합니다. 스킬 디렉터리 안에 스킬용 폴더를 만들고, 그 안에 SKILL.md 파일을 추가합니다. SKILL.md 상단에는 YAML 프론트매터로 이 스킬이 무엇을 돕고 언제 쓰이는지 알려 주는 name과 description을 넣고, 그 아래 에이전트를 위한 상세 지침을 작성합니다.

    Antigravity docs Creating a skill section showing the .agents/skills/my-skill/SKILL.md folder tree and the YAML frontmatter with name and description that every skill needs
    문서는 .agents/skills/my-skill/SKILL.md 트리와 필수 프론트매터를 보여 줍니다.1:20부터 보기
  3. 9

    에이전트가 가장 먼저 읽는 name과 description 작성

    Antigravity는 처음에 프론트매터만 읽으므로, description이 스킬의 발동 조건을 결정합니다. 구체적으로 쓰세요: name: code-review, description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing PRs or checking code quality. 모호하면 스킬은 발동하지 않고, 정확하면 필요한 순간에만 작동합니다.

    Antigravity editor with a new SKILL.md whose YAML frontmatter reads name: code-review plus a description of when the agent should load the skill, beside the .agents/skills/code-reviewer folder in the Explorer
    대화 시작 시 스캔되는 것은 이 몇 줄뿐 — 독자가 아니라 라우터를 위해 쓰는 부분입니다.1:36부터 보기
  4. 10

    스킬이 강제할 정책 추가하기

    프론트매터 아래에 규칙을 마크다운으로 씁니다. sql-reviewer 스킬은 DROP TABLE 금지, 테이블명 snake_case, 모든 테이블에 id 컬럼을 PRIMARY KEY로 요구할 수 있습니다. 본문을 Policies Enforced와 Instructions로 구성하면 에이전트가 규칙과 절차를 모두 파악하고, SQL 작업이 나타날 때만 이 세부 사항을 불러옵니다.

    SKILL.md of a sql-reviewer Antigravity skill listing its Policies Enforced — no DROP TABLE, snake_case table names, an id primary key — plus run_command instructions for a validation script
    팀 컨벤션도 스킬 안에 들어가야 강제 가능한 규칙이 됩니다.2:55부터 보기
  5. 11

    결정적 검증을 위한 스크립트 붙이기

    모델이 눈으로 놓칠 수 있는 규칙은 코드가 더 확실합니다. SKILL.md 옆에 scripts/ 폴더를 만들고, 여기서 validate_schema.py가 각 테이블의 id 기본 키와 snake_case 명명을 검사합니다. SKILL.md에는 파일을 직접 읽지 말고 run_command 도구로 스크립트를 실행한 뒤 종료 코드를 해석하라고 명시합니다. 0이면 통과, 1이면 출력된 오류를 보고합니다.

    Python validate_schema.py script inside the .agents/skills/sql-reviewer/scripts folder that an Antigravity skill runs to flag missing primary keys and non-snake_case table names
    검사는 스크립트가 담당하고, 에이전트는 실행과 결과 전달만 담당합니다.3:56부터 보기
  6. 12

    실제 프롬프트로 스킬 돌려 보기

    에이전트에게 validate @my_schema.sql을 요청합니다. Antigravity는 description으로 sql-reviewer 스킬을 찾고, SKILL.md 전문을 읽고, validate_schema.py를 실행해 결과를 전달합니다. 테스트 파일에서는 ERROR: Table 'users' is missing a primary key named 'id'를 보고하며 수정된 CREATE TABLE까지 제안합니다 — 바로 이 스킬이 수행하도록 작성된 리뷰입니다.

    Antigravity Agent Manager chat reporting ERROR: Table users is missing a primary key named id with a suggested CREATE TABLE fix after running a custom sql-reviewer skill on my_schema.sql
    스킬의 판정과 수정 제안이 채팅에 그대로 나타납니다.4:34부터 보기

탐색, 연결, 검증

  1. 13

    카테고리별로 카탈로그 탐색하기

    라이브러리의 1,300개 이상 스킬은 Architecture, Business, Data & AI, Development, General, Infrastructure, Security, Testing, Workflow로 분류되며 catalog.json으로 검색할 수 있습니다. 팀의 내부 컨벤션에 맞는 것이 없다면 @skillcreator를 불러세요. 질문을 주고받은 뒤 스킬 폴더에 바로 넣을 수 있는 skill.md를 만들어 줍니다.

    Features and Categories table of the Antigravity skills library grouping 1,328+ skills into Architecture, Business, Data and AI, Development, Infrastructure, Security, Testing and Workflow
    9개 카테고리가 카탈로그를 커버하고, 빈틈은 skillcreator가 메웁니다.4:05부터 보기
  2. 14

    워크플로로 스킬 연결하기

    번들은 역할에 어떤 스킬이 중요한지를, 워크플로는 그 사용 순서를 알려 줍니다. Ship a SaaS MVP 워크플로는 Find the scope(브레인스토밍, PRD 라이터), Build backend and API, Build frontend 등으로 이어지며 각 단계마다 사용할 스킬과 예시 프롬프트를 명시합니다. 프로젝트 아이디어와 함께 워크플로 실행을 에이전트에게 요청하면 됩니다.

    Ship a SaaS MVP workflow file from the Antigravity skills repo chaining brainstorming, backend, frontend and security skills into one ordered build plan with prompt samples
    하나의 워크플로 파일이 계획부터 완성품까지 스킬을 순서대로 엮습니다.3:45부터 보기
  3. 15

    결과 검증: 스킬 3개로 대시보드 1개

    저장소 데모에서 @brainstorming은 구조화된 질문(단일 페이지인지 앱인지, 목업 데이터인지 실제 API인지, 반응형 필요 여부)을 먼저 던진 뒤 기획 문서를 만들어 냅니다. 이어서 @frontend-design과 @react-patterns가 사이드바, 타입이 지정된 메트릭 카드 컴포넌트, recharts 선 차트, 활동 피드를 계획에 맞춰 구축합니다. 이것이 스킬의 본질입니다. 결과를 검증할 수 있는 계약을 먼저 세우는 것입니다.

    Analytics dashboard built in Antigravity with the brainstorming, frontend-design and react-patterns skills, showing metric cards, a revenue trend line chart and an activity feed
    완성된 분석 대시보드 — 한 번의 추측이 아니라 구조화된 결과물입니다.6:30부터 보기

Antigravity 스킬 FAQ

관련 가이드