모두가 Gemini 3.5 Flash를 이야기할 때, Google I/O 2026의 진짜 이야기는 Skill File였습니다
요약
Google I/O 2026에서 발표된 Antigravity CLI의 실제 구조를 분석합니다. 에이전트는 JSON으로 정의되고, 재사용 가능한 기능인 'Skill'은 SKILL.md라는 마크다운 파일로 관리되는 계층적 구조를 가집니다.
핵심 포인트
- 에이전트 설정은 JSON, 재사용 기능은 SKILL.md 마크다운 형식을 사용함
- Antigravity CLI는 129개의 내장 기술(built-in skills) 라이브러리를 제공함
- 단순한 프롬프트를 통해 실제 프로젝트에 적용 가능한 커스텀 스킬 생성이 가능함
- 에이전트와 스킬이 분리된 계층적 사고 모델을 제안함
이 글은 Google I/O Writing Challenge를 위한 제출물입니다.
모두가 Google I/O 2026을 떠나며 Gemini 3.5 Flash의 벤치마크에 대해 이야기했습니다. Veo 3, 멀티모달 물리(multimodal physics)를 수행하는 Gemini Omni 등 말이죠. 평소 키노트(keynote)에서 느끼는 설렘이었습니다. 좋은 내용이었고, 예상된 결과였습니다. 하지만 이번 I/O가 왜 개발자들이 제품을 구축하는 방식을 이론이 아닌 실제 프로덕션(production) 환경에서 변화시키는지 이해하고 싶다면, 개발자 키노트에서 단 네 문장 정도만 다뤄졌던 무언가에 주목해야 합니다. 바로 SKILL.md라는 이름의 마크다운(markdown) 파일입니다.
저는 이에 대해 읽기만 한 것이 아니라, 직접 실행해 보았습니다. 실제로 어떤 일이 일어났는지 알려드리겠습니다.
Antigravity CLI가 실제로 생성하는 것 (슬라이드에서 말한 것과는 다름)
제가 읽은 모든 I/O 요약본은 AGENTS.md를 에이전트 설정 프리미티브(primitive)로 설명합니다. 깔끔하고 단순하며, 파일 하나로 구성된다는 것이죠. 하지만 그것은 정확하지 않습니다. 실제 프로젝트에서 Antigravity CLI 1.0.2를 새로 실행했을 때 /agents가 보여주는 내용은 다음과 같습니다:
Create New Agents Workspace: C:/Users/sreej/Downloads/Projects/SoilSense AI/.agents/agents/{agent_name}/agent.json
Global: C:\Users\sreej.gemini\antigravity-cli\agents{agent_name}\agent.json
▼ Available Agents
• /default Default agent
에이전트 정의는 마크다운(markdown)이 아니라 JSON입니다. 마크다운은 한 단계 아래인 skills에 존재합니다:
Skills 129 skills
Create new skills
Workspace: ~/Downloads/Projects/SoilSense AI/.agents/skills/{skill_name}/SKILL.md
Global: ~/.gemini/antigravity-cli/skills/{skill_name}/SKILL.md
Shared: ~/.gemini/skills/{skill_name}/SKILL.md
따라서 실제 구조는 다음과 같습니다:
your-project/
└── .agents/
├── agents/
│ └── {agent_name}/
│ └── agent.json ← 에이전트 동작 (JSON)
└── skills/
└── {skill_name}/
└── SKILL.md ← 재사용 가능한 기능 (markdown)
그리고 Antigravity에는 이미 agency-agentic-search-optimizer부터 agency-code-reviewer에 이르기까지 129개의 내장 기술(built-in skills)이 포함되어 있습니다. 여러분은 제로(zero) 상태에서 시작하는 것이 아닙니다. 라이브러리를 확장하는 것입니다. 이것은 단순한 수정 사항이 아닙니다. 키노트가 암시했던 것과는 다른 사고 모델(mental model)입니다.
실제 프로젝트에서 테스트해 보았습니다. 저는 이것을 SoilSense AI에서 실행했습니다. SoilSense AI는 기존 코드베이스, git 히스토리, 그리고 React 컴포넌트로 가득 찬 src/ 디렉토리를 가진 Capacitor/Android 앱입니다. 데모용 프로젝트가 아닌 실제 프로젝트입니다. 단 하나의 프롬프트: "커밋하기 전에 모든 새로운 컴포넌트의 접근성(accessibility) 문제를 검토하는 SoilSense AI용 스킬을 생성해줘"라고 입력했습니다. 그 결과로 나타난 것은 자동 완성(autocomplete)이 아니었습니다. 에이전트(agent)는 다음과 같이 동작했습니다:
- 스택을 이해하기 위해 package.json을 읽음
- src/, src/lib/, docs/PROJECT_STRUCTURE.md를 스캔함
- ListPermissions를 확인하여 읽기/쓰기 권한을 확인함
- 현재 상태를 파악하기 위해 git status를 실행함
- 하이브리드 접근 방식을 제안하고 진행하기 전에 승인을 요청함
에이전트가 제안한 계획은 다음과 같습니다:
- 글로벌 AI 에이전트 스킬 (soilsense-accessibility-reviewer) — 즉, LLM 수준의 추론을 사용하여 git-staged 컴포넌트를 감사하도록 에이전트에게 지시하는 SKILL.md
- 정적 WCAG 규칙 강제를 위한 독립형 Python 체크 도구 (check-a11y.py)
- 심각한 위반 사항이 포함된 커밋을 차단하는 pre-commit git hook
저는 proceed(진행)라고 입력했습니다. 에이전트가 구축한 결과물은 다음과 같습니다:
- Create(~/.gemini/config/skills/soilsense-accessibility-reviewer/SKILL.md)
- Create(~/.gemini/config/skills/soilsense-accessibility-reviewer/scripts/check_a11y.py)
- Create(SoilSense AI/scripts/check-a11y.py)
- Create(SoilSense AI/.git/hooks/pre-commit)
그 후 — 제가 요청하지 않았음에도 불구하고 — 에이전트는 의도적인 위반 사항이 포함된 가짜(mock) 오류 컴포넌트를 생성하고, 이를 스테이징(staged)한 뒤, 검증을 위해 스스로에게 hook을 실행했습니다. 결과는 다음과 같습니다:
5개의 심각한(Critical) 문제 감지:
- alt 태그 누락
- tabIndex/onKeyDown 핸들러가 없는 커스텀 클릭 가능 div
- 빈 버튼
- 레이블이 없는 form 입력창
3개의 경고(Warnings):
- 중복된 alt 용어
- 잘못된 tabIndex 안티 패턴
- 레이블이 없는 장식용 SVG/Lucide 아이콘
→ 커밋 차단됨. 심각한 문제를 수정하거나 --no-verify를 사용하여 우회하십시오.
에이전트는 실제 위반 사항을 포착하고, 커밋을 차단하고, 결과를 콘솔 테이블에 표시한 다음, 가짜 컴포넌트를 정리하고 git 상태를 초기화했습니다. 이제 pre-commit hook은 SoilSense AI 리포지토리에서 활성화되었습니다. 단 하나의 프롬프트로 가능했습니다. 오케스트레이션(orchestration) 코드도, 수동으로 작성한 설정 파일도 필요 없었습니다.
I/O 보도 내용에서 아무도 설명하지 않고 있는 사실이 바로 이것입니다. Skill file은 단순히 에이전트가 무엇을 아는지(knows)를 바꾼 것이 아니라, 에이전트가 여러분의 저장소(repository)에 무엇을 하는지(does)를 바꾸었습니다.
아무도 명확하게 설명하지 않는 Gemini CLI의 은퇴
Antigravity 2.0 발표에 숨겨진 세부 사항은 다음과 같습니다: Gemini CLI는 2026년 6월 18일에 소비자 등급(consumer tiers)에서 종료됩니다. 이는 선택 사항이 아닙니다. 무료 등급(Free tier), AI Pro, AI Ultra 모두에게 동일한 메시지가 적용됩니다.
| 구분 | Gemini CLI | Antigravity CLI |
|---|---|---|
| 런타임 (Runtime) | Node.js 런타임 | Go 바이너리 — 런타임 의존성 없음 |
| 설정 파일 | GEMINI.md, AGENTS.md, /agent.json | .gemini/skills/, .agents/skills/{name}/SKILL.md |
| 모델 | Gemini 모델 전용 | Gemini 3.5 Flash + Claude + GPT-OSS |
| 접근 방식 | 채팅 중심 (Chat-first) | 에이전트 오케스트레이션 중심 (Agent orchestration-first) |
| 라이선스 | 오픈 소스 (Open source) | 폐쇄형 소프트웨어 (Closed software) |
멀티 모델 라우팅(multi-model routing) 부분은 잠시 멈춰서 생각해 볼 가치가 있습니다. Antigravity CLI는 동일한 인터페이스를 통해 Claude 및 GPT-OSS 모델을 지원하므로, CLI 계층에서 Gemini에 종속되지 않습니다. Managed Agents API는 구체적으로 Gemini 3.5 Flash를 대상으로 하지만, 로컬에서는 모델 선택권이 있습니다.
마지막 행은 제가 계속 생각하게 만드는 부분입니다. Gemini CLI는 오픈 소스였습니다. 수만 명의 기여자가 있었고, 이를 기반으로 한 포크(forks)와 확장 기능들이 구축되었습니다. Antigravity는 폐쇄형입니다. Google은 개발자 도구를 자사의 수익화 스택(monetization stack)으로 이동시키면서 이를 업그레이드라고 부르고 있습니다. 이는 정확한 표현입니다. 하지만 불완전한 설명이기도 합니다.
129개의 내장 기술(Built-In Skills)이 실제로 의미하는 것
/skills 명령어가 129개의 내장 기술을 보여주었을 때, 저는 그것들을 하나씩 살펴보았습니다. 눈에 띄는 몇 가지는 다음과 같습니다:
- agency-agentic-search-optimizer — AI 에이전트가 사이트에서 실제로 작업을 수행할 수 있는지 감사 (WebMCP 준비 상태 확인)
- agency-ai-data-remediation-engineer — 에어갭(air-gapped) 로컬 SLM(Small Language Models)을 사용하여 자가 치유(self-healing) 데이터 파이프라인 구축
- agency-autonomous-optimization-architect — 재무적 제약을 준수하면서 성능을 위해 API를 섀도 테스트(shadow-tests)
- agency-codebase-onboarding-engineer — 새로운 엔지니어가 익숙하지 않은 코드베이스를 이해하도록 지원
이것들은 단순한 자동 완성(autocomplete)의 개선이 아닙니다. 이것들은 행동(behaviors)입니다. 즉, 에이전트가 호출되었을 때 자율적으로 수행할 작업들입니다. Skill file은 바로 이 명령어 세트(instruction set)입니다.
에이전트는 실행자(executor)입니다. 제가 SoilSense AI를 위해 구축한 접근성 검토기(accessibility reviewer)는 이제 130번째 스킬이 되었습니다. 이 스킬은 ~/.gemini/config/skills/soilsense-accessibility-reviewer/SKILL.md에 위치합니다. 해당 프로젝트 내의 모든 향후 Antigravity 세션은 이를 호출할 수 있습니다. 이것이 바로 원시 단위(primitive)입니다. 단순한 기능(feature)이 아닙니다. 버전 관리 시스템(version control)에 저장되는, 에이전트 행동의 조립 가능한 단위(composable unit)입니다.
제가 신중하게 접근해야 할(Push Back) 몇 가지 사항들이 있습니다. 폐쇄 소스(closed-source) 문제는 실재합니다. Gemini CLI가 오픈 소스였다는 것은 커뮤니티가 자신의 코드베이스에 파일 시스템 접근 권한을 가진 도구를 감사(audit)할 수 있음을 의미했습니다. Antigravity는 폐쇄적입니다. 이 도구가 생성한 pre-commit hook은 ~/.gemini/config/skills/에서 코드를 실행하는데, 이 경로는 Google이 설치 시점에 콘텐츠를 제어합니다. 개인 프로젝트라면 괜찮습니다. 하지만 기업용(enterprise) 서비스라면, 에이전트 런타임(agent runtime)이 귀하의 코드에 대해 무엇을 할 수 있고 무엇을 할 수 없는지에 대한 답을 확신하기 전에 반드시 알아야 합니다.
proceed 명령어가 너무 많은 일을 하고 있습니다. 에이전트는 실행 전에 승인을 요청했습니다. 저는 전체 구현 계획을 읽지 않고 proceed를 입력했습니다. 그러자 에이전트는 네 군데의 위치에 파일을 생성하고, git hook을 수정하며, 실제 저장소(repository)를 대상으로 git commit을 실행했습니다. 이 워크플로우는 사용자가 계획을 주의 깊게 검토할 것을 가정합니다. 하지만 실제로 마감 압박에 시달리는 대부분의 개발자는 그렇게 하지 않을 것입니다. 이는 기술적인 문제가 아니라 거버넌스(governance)의 문제이지만, 사고를 유발할 수 있는 종류의 문제입니다.
스킬의 범위 확장(scope creep)도 쉽게 일어납니다. 접근성 검토기 스킬은 전역적(global)입니다. SoilSense AI 프로젝트 디렉토리가 아닌 ~/.gemini/config/skills/에 존재하기 때문입니다. 이는 이 머신에 있는 모든 프로젝트의 모든 Antigravity 세션에서 이 스킬을 사용할 수 있음을 의미합니다. 편리하긴 하지만, 디버깅하기 어려운 방식으로 서로 충돌하는 60개의 전역 스킬을 갖게 되는 결과로 이어질 수도 있습니다. Antigravity의 스킬 우선순위 시스템(Workspace → Global → Shared)이 이를 처리하지만, 사용자는 이 시스템이 존재한다는 사실을 알고 있어야 합니다.
시작하기 (제가 실제로 사용한 Windows 기준) # https://antigravity.google.com/download 에서 다운로드 # 또는 winget을 통해 설치 (해당 지역에서 사용 가능한 경우) winget install Google.AntigravityCLI # 프로젝트 디렉토리로 이동 cd "C:\Users\you\Projects\your-project" # agy 실행 # 셸 내부에서 — 사용 가능한 항목 탐색 /skills # 129개의 내장 스킬(built-in skills)과 사용자가 생성한 스킬 확인 /agents # 사용 가능한 에이전트(agents) 확인 (시작하려면 /default 입력) # 일반적인 영어 프롬프트로 첫 번째 스킬 생성 # 예시: "create a skill that enforces our API response schema before any PR" (모든 PR 전에 우리 API 응답 스키마를 강제하는 스킬을 생성해줘) 무엇인가를 작성하기 전에 /skills부터 확인하세요. 여러분이 원하는 기능이 이미 129개의 내장 스킬 중에 존재할 가능성이 높습니다. 스킬 생성 워크플로(일반 영어 → 에이전트가 SKILL.md + 지원 스크립트 + 테스트를 구축)는 실제로 작동하는 무언가를 만드는 가장 빠른 경로입니다.
진정한 핵심(The Real Take)
Google은 I/O 2026에서 더 나은 자동 완성(autocomplete) 기능을 출시한 것이 아닙니다. 그들은 에이전트 동작(agent behavior)을 위한 런타임(runtime)을 출시했으며, 여러분에게 텍스트 파일을 구성 인터페이스(configuration interface)로 제공했습니다. Antigravity CLI에 입력한 단 하나의 프롬프트가 제가 실제로 구축 중인 실제 Android/Capacitor 프로젝트를 위한 WCAG 접근성 검토기, Python 정적 분석 엔진, git pre-commit hook, 그리고 자체 검증 테스트를 만들어냈습니다. 이 커밋 훅(commit hook)은 지금 바로 활성화되어 있습니다. 이는 다음 접근성 위반 사항이 저장소(repo)에 반영되기 전에 차단할 것입니다.
Gemini 3.5 Flash의 벤치마크는 6개월 안에 구식이 될 것입니다. 하지만 모든 커밋마다 팀의 표준을 강제하는 스킬 파일은 복리 효과를 일으킵니다. 이 플랫폼은 인상적입니다. 130번째 스킬이 바로 이것을 실체로 만듭니다.
여러분의 첫 번째 커스널 스킬로 무엇을 만들고 싶으신가요? 린터 규칙(linter rule), PR 설명 생성기, 아니면 여러분의 스택에 특화된 무언가인가요? 특히 누군가가 워크스페이스 범위(workspace-scoped) 스킬을 글로벌 스킬과 충돌 없이 함께 작동시키는 데 성공했는지 매우 궁금합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기