
구글 공식 에이전트 스킬이 나왔다는데, 마케터는 뭘 골라 설치해야 할까요? (2026 기준)
Free Resource
PDF · Free
구글 공식 AI 에이전트 스킬, 마케터는 어디까지 쓸까
Get the practical guide first, before diving into the full article.
구글 공식 에이전트 스킬이 나왔다는데, 마케터는 뭘 골라 설치해야 할까요? (2026 기준)
구글이 GitHub에 공개한 공식 에이전트 스킬은 2026-11-09 index.json 기준 187개이고 마케터 몫은 애즈 14개와 GA4 2개예요. 설치 전에 전제조건을 확인해야 해요.
구글 공식 에이전트 스킬은 무엇이고 지금 몇 개인가요?
구글 공식 에이전트 스킬(google/skills)은 구글이 자기 제품 사용법을 AI 에이전트가 읽는 문서로 직접 써서 올려 둔 저장소입니다. 2026-11-09 index.json 기준 187개가 들어 있어요.
"구글이 공식으로 만들었다는데 우리 광고 계정에도 바로 쓸 수 있나요?" 소식을 들으면 이 질문부터 떠오르죠. 답부터 말하면 마케터 몫은 작고 전제조건이 무겁습니다. 이 글은 스킬이 무엇인지, 마케터에게 돌아오는 몫이 얼마인지, 설치 전에 어디를 확인해야 하는지를 날짜와 조건까지 붙여 짚어 볼게요.
스킬은 출시 글 표현으로 "compact, agent-first documentation for a specific technology or task"입니다. 특정 기술이나 작업을 위한 짧은 에이전트용 문서라는 뜻이에요. 에이전트는 필요할 때만 내용을 불러옵니다. 구글 출시 글에 따르면 저장소는 2026-04-22 Google Cloud Next 2026 첫날 13개로 시작했어요.
2026-11-09에는 index.json이 187개이고 skills/ 폴더는 188개입니다. 차이 1개는 SKILL.md 없이 스크립트만 든 폴더예요. 같은 날 폴더 기준 분포는 클라우드 167개, 구글 애즈 14개, 개발자 도구 3개, 애널리틱스 2개, 로그인·인증 2개입니다.
마케터가 쓸 수 있는 스킬은 몇 개이고 전제조건은 무엇인가요?
2026-11-09 폴더 기준으로 구글 애즈 스킬 14개 중 Google Ads API 스킬이 3개(계정 성과 진단, MCP 서버 설치, 퀵스타트), Data Manager API 스킬이 3개이고 나머지 8개는 앱과 동영상 광고 SDK를 붙이는 개발자용이에요. GA4는 보고서를 뽑는 Data API와 계정·속성을 관리하는 Admin API 스킬 2개가 있어요.
계정 진단 스킬(google-ads-api-account-diagnostics 버전 1.0.2)은 Google Ads MCP 서버(MCP는 에이전트가 외부 프로그램과 연결되는 표준 규격)가 붙어 있어야 실제 계정을 조회합니다. 없으면 직접 돌릴 GAQL(구글 애즈 조회 언어) 쿼리 초안과 점검 계획만 내줘요. 진단 주제는 전환과 전환 가치 손실, 노출 점유율 손실, 리드 유입 저조, 오프라인 업로드 점검 4가지입니다.
문제는 MCP 서버를 붙이는 일이에요. MCP 서버 설치 스킬(버전 1.0.0)에 따르면 Python 3.12 이상과 pipx가 필요하고 인증 정보 5가지를 미리 준비해야 합니다. 개발 도움 없이 혼자 끝내기는 어렵다는 건 제 해석이에요.
GA4 Data API 스킬(버전 1.0.0)도 마찬가지로 gcloud(구글 클라우드 명령줄 도구)를 깔고 구글 클라우드 프로젝트에서 gcloud services enable analyticsdata.googleapis.com으로 API를 켠 뒤 읽기 전용 범위로 로그인해야 해요. 웹사이트에 GA 태그를 심는 일은 이 스킬 범위 밖입니다.
공식 스킬인데 연결된 문서와 어긋나는 곳이 있다는 게 사실인가요?
네, 확인한 범위에서 두 군데가 있어요.
첫째는 조회 전용 문장입니다. 스킬 1.0.0은 "The Google Ads MCP Server is currently strictly read-only."라고 씁니다. 그런데 구글 애즈 MCP 서버 README(2026-11-09 확인)에는 쓰기 도구 4종(create_asset, upload_video_asset, manage_labels, manage_label_associations)이 적혀 있어요. 이 도구들은 반영 전에 미리보기와 사용자 승인을 거치는 2단계(Propose & Confirm)로 동작해요. 기본 설정에서는 도구가 전부 켜져 있습니다.
README는 "For strictly read-only deployments, set labels: false and assets: false in your tools_config.yaml."라고 안내해요. 조회만 쓰고 싶다면 이 설정부터 하는 편이 안전하다는 건 제 해석입니다. 같은 README는 "The MCP Server will expose your data to the Agent or LLM that you connect to it."라고 경고해요. 연결한 에이전트에 계정 데이터가 보인다는 점도 따져야 합니다.
둘째는 개발자 토큰(구글 애즈 API 호출에 쓰는 승인 키)입니다. 같은 스킬은 인증 정보 5가지 중 첫째로 개발자 토큰을 적어요. 그런데 구글 애즈 API 접근 등급 문서(2026-10-30 갱신)의 시작 안내 상자에는 "Developer tokens were sunset on September 9, 2026"라는 문장이 있습니다. 기존 연동의 토큰이 어떻게 되는지는 이 페이지가 말하지 않아요. 어느 쪽이 맞는지 단정할 수 없으니 설정 전에 API 문서와 서버 README를 먼저 보는 편이 낫다는 게 제 해석이에요.
설치는 어떻게 하고 스킬과 플러그인은 무엇이 다른가요?
스킬과 플러그인은 다른 물건입니다. 스킬만 설치하려면 README의 npx skills add google/skills를 써요. 설치 중에 스킬과 대상 에이전트, 범위(프로젝트 또는 전역)를 골라요. 갱신은 npx skills update로 직접 해야 해요. 구글 2026-10-28 글에 "Skills don't auto-update in the background"라는 문장이 있어서 자동 갱신은 없다고 보면 됩니다.
플러그인은 README 설명으로 스킬과 MCP 서버를 묶은 것입니다. Claude Code에서는 터미널에서 2단계면 돼요.
claude plugin marketplace add google/skills
claude plugin install <plugin>@google-plugins
이 형식은 Claude Code 공식 문서의 마켓플레이스 명령 형식과 같아요. 다만 문서는 "A plugin can run hooks and MCP servers, so read the pane before you install."라고 경고합니다. 설치 전에 상세 패널을 읽으라는 뜻이에요. README에 Claude Code, Codex, Antigravity 설치 표가 있고 저장소에 Claude Code용 마켓플레이스 파일이 있다는 데까지 확인했어요.
2026-11-09 marketplace.json 기준 플러그인은 17개이고 이름은 alloydb, bigquery, cloud-sql 3종, firestore-native, google-cloud-developer, looker, spanner 등 클라우드와 데이터 쪽입니다. 애즈나 GA 이름이 붙은 플러그인은 없어요. 17개 중 16개는 GoogleCloudPlatform 조직의 다른 저장소에서 받아 옵니다.
구글은 스킬 품질을 어떻게 관리한다고 밝혔나요?
2026-10-28 Google Cloud 블로그 글(Remigiusz Samborski)에 따르면 구글은 "a skill is a living product, not a one-off document."라는 원칙으로 스킬을 다룹니다. 공개 저장소로 내보내기 전에 자동 게이트 6개와 사람 승인을 거쳐요. 게이트는 구조 적합성, 스킬 린터(형식 규칙 검사기), 시맨틱 버전(바뀔 때마다 버전 올리기), 평가 묶음, 링크 확인, AI 리뷰 에이전트입니다. 사람 승인은 보통 해당 분야 전문가가 맡고, 새 스킬이면 Central Skills 팀 구성원도 검토해요.
구글이 밝힌 스킬 공개 절차 도식: 빠른 기계 점검, 그 밖의 자동 게이트, 사람 승인, GitHub 공개 저장소로 내보내기
구글은 빠른 기계 점검 셋 중 하나라도 실패하면 AI 리뷰와 평가를 돌리지 않고, 자동 게이트 6개와 사람 승인을 모두 거친 스킬만 공개 저장소로 내보낸다고 밝혔습니다
자료: 구글 클라우드 블로그(2026-10-28) · QJC 재구성
바뀐 스킬은 이전 버전과 비교하고 새 스킬은 스킬 없는 에이전트와 비교한 평가 보고서를 붙인다고 해요. 외부 링크는 매주 월요일 점검합니다. SKILL.md 본문은 500줄 미만으로 짧게 두고 정해진 명령 순서는 지시문 대신 스크립트로 둔다고 써요. 리뷰도 스킬이 하는데 글은 "Yes, we use a skill to review skills."라고 답합니다.
절차가 있다는 것과 개별 스킬이 연결된 문서와 일치하는지는 따로 봐야 해요. 제 해석입니다.
스킬에 붙은 사용량 표시 태그와 finding-google-skills는 무엇인가요?
2026-11-09 기준 155개 스킬(클라우드 154개, 개발자 도구 1개)에는 references/attribution.md 파일이 있어요. 구글 애즈와 애널리틱스 스킬에는 없습니다. 에이전트가 터미널에서 실행하는 명령에 스킬 이름과 버전 태그를 붙이라는 지시예요. 구글 설명은 "The tag identifies only the skill and its version; it carries no user data."입니다. 사용자가 끄라고 하면 태그를 빼라는 지시와 사용자에게 주는 코드에는 넣지 말라는 지시도 같이 있어요. 사용자 데이터가 없다는 것은 구글의 설명이에요. 데이터가 오가는 경로는 따로 확인하지 못했습니다.
finding-google-skills는 스택을 고르는 질문에서 구글 제품이 합리적 후보이면 사용자가 벤더를 말하지 않아도 구글 카탈로그를 불러오도록 쓰여 있어요. 다른 공급자로 이미 정해졌고 구글 제품을 말하지 않았으면 건너뛰어요.
확인한 SKILL.md 6개와 index.json 187개 설명(앞부분 기준)은 전부 영어예요. 한국어로 물어도 에이전트가 읽는 지시는 영어입니다.
우리 팀은 이 스킬을 어떻게 쓰면 되나요?
여기서부터는 원문이 아니라 제 해석이에요.
- 쓰는 제품의 스킬만 골라서 깔고 전체를 설치하지 않아요.
- 설치 전에 SKILL.md를 열어 전제조건(계정, 키, 도구)과 범위를 확인해요.
- 애즈 MCP 서버를 붙인다면
labels: false,assets: false설정으로 조회 위주부터 시작해요. - 사용량 표시 태그가 싫으면 에이전트에게 빼라고 말해요.
- 자동 갱신이 없으니 쓰는 버전을 정해 두고 주기적으로
npx skills update를 돌려요. - 우리 팀 스킬을 만들 때 구글 방식을 빌려요. 버전 올리기, 이전 버전과 비교 평가, 기계 점검 먼저, 본문 500줄 미만이에요.
- 2026-11-09 기준 저장소에는 네이버나 카카오 광고용 스킬이 없으니 한국 광고 운영 전체를 맡기는 도구로 보지 않아요.
마무리
구글 공식 에이전트 스킬은 2026-11-09 index.json 기준 187개이고 마케터에게 닿는 것은 구글 애즈 14개와 GA4 2개예요. 구글은 6개 자동 게이트와 사람 승인을 밝혔지만 스킬 문서가 서버 README·API 문서와 어긋나는 곳도 확인했습니다. 쓰는 제품 스킬 하나를 골라 SKILL.md 원문부터 열어 보셔도 충분해요. 전제조건 목록이 우리 팀 환경과 맞는지가 판단 기준입니다.
자주 묻는 질문
구글 애즈 MCP 서버를 붙이면 내 계정 데이터가 바뀔 수도 있나요?
쓰기 도구가 들어 있어요. 서버 README(2026-11-09 확인)에 쓰기 도구 4종이 적혀 있고 반영 전에 미리보기와 사용자 승인을 거치는 2단계로 동작해요.
네이버나 카카오 광고에도 쓸 수 있나요?
2026-11-09 기준 저장소에서 네이버나 카카오 광고용 스킬은 찾지 못했어요. 구글 쪽 몫도 구글 애즈 14개와 GA4 2개로 작아서 한국 광고 운영 전체를 맡기는 도구로 보기는 어려워요.
스킬을 깔면 자동으로 최신 상태가 유지되나요?
아니요. 구글 2026-10-28 글에 따르면 스킬은 백그라운드에서 자동 갱신되지 않아요. 직접 npx skills update를 돌려야 해요.


