Google Agent Skills가 OpenAPI 대신 마크다운을 고른 이유

Google이 Google Cloud Next 2026에서 공식 에이전트 스킬 리포지터리(Agent Skills Repository)를 발표했다. Vertex AI, BigQuery, Cloud Run, GKE, Firebase, Gemini API 등 핵심 Google Cloud 서비스를 AI 에이전트와 연결하는 표준화된 인터페이스 계층으로, MCP와 병렬로 운용되는 거버넌스 가능한 에이전트 기능 확장 체계다. 이 스킬 컬렉션은 에이전트가 필요할 때만 스킬 정보를 로드하는 방식으로 컨텍스트 비대화를 방지하면서도 클라우드 서비스 통합의 복잡도를 대폭 낮춘다.

마크다운 한 장이 스킬 파일이 되는 방식

Google Agent Skills는 마크다운 기반의 단순한 개방형 포맷으로 정의된다. 각 스킬 파일은 서비스 설명, 입출력 스키마, 코드 스니펫, 레퍼런스 파일을 포함하며 에이전트가 요청 시 동적으로 로드한다. 스킬 디스커버리는 github.com/google/skills 리포지터리를 중앙 카탈로그로 사용하고, Gemini Enterprise Agent Platform 내에서 자동 인덱싱된다.

스킬 인터페이스의 핵심 설계 원칙은 지연 로딩(Lazy Loading), 스키마 표준화, 버전 관리다. 지연 로딩은 에이전트가 실행 중 필요한 스킬만 컨텍스트 윈도우에 주입해 토큰 낭비를 방지한다. 스키마 표준화는 입출력 파라미터를 JSON Schema로 선언해 다양한 오케스트레이터와 호환되도록 한다. 버전 관리는 스킬 파일이 Git 태그 기반 버전을 따르도록 해, 에이전트 설정에서 고정 버전을 참조할 수 있게 한다.

Google Cloud 서비스 스킬은 Workload Identity Federation을 통해 에이전트 실행 컨텍스트의 서비스 계정 권한을 위임받는다. OAuth 2.0 토큰 갱신, IAM 역할 검증, 세분화된 API 스코프 설정이 스킬 레이어에서 추상화된다. 에러 처리 패턴은 재시도 가능한 에러(일시적 네트워크 오류, 할당량 초과)와 재시도 불가능한 에러(권한 없음, 잘못된 입력)를 구분하여 에이전트가 적절한 폴백 전략을 선택하도록 유도한다.

⤢✕

스킬을 체이닝해 클라우드 서비스를 엮다

Gemini Enterprise Agent Platform(구 Vertex AI)에서 여러 스킬을 순차·병렬로 체이닝하는 오케스트레이션 레이어는 ADK(Agent Development Kit)가 담당한다. ADK는 스킬 의존성 그래프를 빌드 타임에 분석하고, 실행 시 병렬 실행 가능한 스킬 호출을 자동으로 배치한다.

BigQuery MCP 서버와 Agent Skills를 함께 사용하는 패턴에서 에이전트는 자연어 질의를 SQL로 변환하고, BigQuery 스킬을 통해 쿼리를 실행한 뒤 결과를 구조화된 형태로 반환한다. BigQuery MCP 서버는 Google이 완전 관리형으로 제공하는 원격 엔드포인트로, 스키마 자동 검색, 쿼리 비용 예측, 결과 페이지네이션을 지원한다.

Cloud Storage 스킬은 오브젝트 업로드·다운로드·메타데이터 조회 외에도 대용량 파일에 대한 청크 분할 처리 패턴을 포함한다. 에이전트가 50MB 이상의 파일을 처리할 때 스킬은 자동으로 병렬 분할 업로드(Parallel Composite Upload)로 전환한다. Cloud Run 스킬은 에이전트가 커스텀 코드 실행이 필요할 때 사전 빌드된 컨테이너를 온디맨드로 호출하는 패턴을 표준화한다. 코드 실행 결과는 Cloud Storage에 저장되고, 에이전트는 GCS 스킬로 결과를 수집한다.

Apigee는 기존 REST API를 MCP 브릿지로 변환하는 게이트웨이 역할을 수행한다. 기업 내부의 레거시 서비스도 Apigee 정책을 통해 에이전트 스킬로 노출 가능하며, 기존 인증·인가·속도 제한 거버넌스를 그대로 유지한다.

Anthropic·OpenAI와는 무엇이 다른가

세 플랫폼은 모두 에이전트와 외부 서비스를 연결하는 표준 인터페이스를 목표로 하지만 접근 방식이 다르다.

항목	Google Agent Skills	Anthropic Connectors	OpenAI Actions
포맷	Markdown + JSON Schema	OpenAPI 스펙 + MCP	OpenAPI 스펙
로딩 방식	지연 로딩(on-demand)	연결 설정 시 고정	함수 정의 배열
거버넌스	IAM + Workload Identity	API Key + OAuth	API Key
클라우드 연동	GCP 네이티브 통합	서드파티 중립	Azure/OpenAI 중심
오픈소스	github.com/google/skills	비공개	비공개
버전 관리	Git 태그 기반	미지원	스키마 해시

Google Skills의 차별점은 클라우드 네이티브 인증 위임과 마크다운 기반 단순 포맷이다. 개발자가 신규 스킬을 제작할 때 OpenAPI 스펙 작성 없이 마크다운 문서만으로 에이전트에 노출할 수 있는 진입 장벽을 낮춘 점이 핵심이다.

Google Cloud Next 2026 발표 직후 커뮤니티 기여 스킬이 증가하고 있다. Gemini Enterprise Agent Platform은 에이전트 빌더, 오케스트레이터, 거버넌스, 최적화를 단일 플랫폼에 통합함으로써 개발자가 스킬 생태계에 기여하는 피드백 루프를 가속화하는 구조다. 향후 Google은 파트너 스킬 프로그램을 통해 Salesforce, SAP, ServiceNow 등 주요 엔터프라이즈 SaaS의 공식 스킬도 리포지터리에 추가할 계획이다.

Google Agent Skills는 에이전트와 클라우드 서비스 통합의 복잡도를 마크다운 기반 단순 포맷으로 추상화한 실용적 표준화 시도다. MCP 기반 완전 관리형 원격 서버와 Skills 리포지터리가 병렬로 운용되는 구조는 에이전트 개발자에게 유연한 통합 경로를 제공한다. Anthropic Connectors, OpenAI Actions와의 경쟁 속에서 클라우드 네이티브 인증 위임과 오픈소스 생태계 전략이 Google Skills의 장기적 경쟁력을 결정할 것이다.

마크다운 한 장이 스킬 파일이 되는 방식

스킬을 체이닝해 클라우드 서비스를 엮다

Anthropic·OpenAI와는 무엇이 다른가

Sources

함께 읽기