결론부터. 구글의 google/skills 저장소에는 공개 표준 에이전트 스킬 104개와 클로드 코드용 플러그인 카탈로그 16개가 함께 들어 있다. 두 묶음은 같은 설치 대상이 아니다. 104개 중 90개가 구글 클라우드에 집중돼 있고, 설명문 원문은 약 4.46만 자였다.
구글이 낸 클로드 코드 플러그인 저장소를 직접 받아서 파일을 세어보고, 설치 경로를 확인하고, 설명문 분량을 실측했다. 아래는 전부 그 결과다.
구글이 낸 클로드 코드 플러그인이란
google/skills는 구글 제품과 기술을 다루는 에이전트 스킬 모음이다. 아파치 2.0 라이선스이고, 2026년 8월 10일 확인 시점에 별 약 1만 7천 개가 붙어 있다.
여기서 헷갈리기 쉬운 게 하나 있다. 저장소 안에 .claude-plugin/marketplace.json이 들어 있다. 클로드 코드가 플러그인 마켓플레이스를 인식하는 바로 그 파일이다. 다만 이 파일은 스킬 104개를 플러그인으로 포장한 것이 아니다. 외부 저장소에 있는 플러그인 16개를 가리키는 별도 카탈로그다. 스킬과 플러그인은 같은 저장소에 있을 뿐 서로 다른 묶음이다.
아래 내용은 커밋 092e210(2026-08-07) 기준으로 저장소를 내려받아 확인했다.
1. 클로드 코드 플러그인 설치는 세 갈래다
README가 안내하는 경로는 이렇다.
# 골라서 설치 (권장)
npx skills add google/skills
# 클로드 코드 마켓플레이스로 추가
claude plugin marketplace add google/skills
claude plugin install <plugin>@google-plugins
# 코덱스
codex plugin marketplace add google/skills
# 안티그래비티 CLI
agy plugin install https://github.com/google/skills/<plugin-path>첫 번째 npx 명령이 중요하다. README에 “설치할 스킬을 골라서 선택할 수 있다”고 적혀 있다.
그리고 이 세 명령이 서로 다른 것을 설치한다. 헷갈리기 쉬운 지점이라 정리해둔다.
| 명령 | 설치되는 것 |
|---|---|
npx skills add | 저장소 안 스킬 104개 중 골라서 |
plugin marketplace add | 카탈로그만 등록. 설치되는 것은 없다 |
plugin install | 플러그인 16개 중 개별로 |
즉 마켓플레이스를 추가했다고 스킬 104개가 들어오는 것이 아니다. 그리고 설치한 플러그인을 비활성화하면 새 세션부터는 활성 목록에서 빠진다.
2. 전부 깔면 안 되는 이유
클로드 코드의 스킬은 본문 전체가 항상 올라가지 않는다. 시작할 때는 활성 스킬의 이름과 설명 목록이 들어가고, 실제 본문은 그 스킬이 필요하다고 판단될 때 읽는다. 설계는 합리적이다.
다만 이 목록이 무한정 늘어나는 것은 아니다. 문서에 따르면 목록에는 예산이 있고, 이를 넘으면 설명이 축약되거나 일부가 빠질 수 있다. disable-model-invocation이나 설정 재정의로 특정 스킬의 설명 비용을 아예 없앨 수도 있다. 그래서 “몇 개를 깔면 몇 토큰”이라는 계산은 성립하지 않는다. 실제 비용은 클로드 코드에서 /context로 직접 재야 한다.
저장소의 SKILL.md 104개를 전부 세어봤다.
| 항목 | 실측 | 비고 |
|---|---|---|
| 스킬 개수 | 104개 | SKILL.md 파일 수 |
| 설명문 원문 | 약 44,600자 | 이름까지 더하면 약 47,500자 |
| 설명문 평균 | 약 430자 | 스킬 하나 기준으로는 평범 |
| SKILL.md 전체 합계 | 1,082,648자 | 프론트매터 포함 |
| 본문만 합계 | 1,025,848자 | 평균 9,863자 · 최대 39,027자 |
여기서는 토큰이 아니라 글자 수만 적었다. 흔히 쓰는 “네 글자에 한 토큰” 환산은 영문 산문 기준이고, 이 설명문에는 서비스명과 API 이름이 많이 섞여 있어 실제와 차이가 난다. 게다가 널리 쓰이는 토큰 계산 도구는 다른 회사 모델용이라 클로드의 실제 소모량을 증명하지 못한다.
주목할 건 스킬 하나당 430자는 문제가 아니라는 점이다. 설명문 한 개의 분량으로는 평범하다. 다만 104를 곱하면 4.5만 자가 되고, 그만큼이 시작 목록의 재료가 된다. 실제로 얼마가 들어가는지는 예산과 설정에 따라 달라지므로, 숫자를 믿지 말고 재보는 편이 맞다.
그래서 결론은 단순하다. 필요한 것만 골라 깐다. npx skills add가 선택 설치를 지원하는 이유가 여기에 있다. 그리고 설치 전후로 /context를 한 번씩 찍어두면 내 환경에서의 실제 비용을 알 수 있다.
3. 클로드 코드 플러그인 안에 뭐가 들어 있나
| 분류 | 개수 | 내용 |
|---|---|---|
| cloud | 90 | 구글 클라우드 인증·온보딩, GKE 추론 이관, 에이전트 플랫폼 운영(알림·엔드포인트·평가·모델 튜닝·프롬프트 관리·RAG 엔진), 모니터링 지표 선택 등 |
| ads | 12 | 구글 애즈 API 진단·퀵스타트·MCP 설치, 모바일 애즈 SDK(배너·전면·보상형), 데이터 매니저 API, IMA SDK |
| analytics | 2 | 구글 애널리틱스 Admin API, Data API |
104개 중 90개가 구글 클라우드 제품과 워크플로에 집중돼 있다. GCP를 쓰지 않는다면 직접적인 운영 가치는 제한적이다. 다만 전부 쓸모없다고 말하면 과하다. 아키텍처 설계, 검토 체크리스트, GKE용 설정 파일 생성처럼 계정 없이도 참고할 수 있는 성격의 스킬이 섞여 있다. 실제로 필요한지는 목록을 훑어보고 판단하는 편이 맞다.
클라우드 밖의 14개는 성격이 뚜렷하다. 구글 애즈를 집행하거나, 모바일 앱에 광고를 붙이거나, 애널리틱스 API를 다루는 경우다. 해당하지 않으면 볼 이유가 없다.
4. 플러그인과 스킬은 뭐가 다른가
클로드 코드 플러그인을 찾다가 이 저장소에 닿으면 헷갈리기 쉽다. 겉은 플러그인 마켓플레이스인데 안에 든 건 대부분 스킬이다.
| 구분 | 정체 | 이 저장소에서 |
|---|---|---|
| 스킬 | SKILL.md 한 장. 지시문 묶음 | 104개 |
| 플러그인 | 스킬·명령·MCP 서버를 묶어 배포하는 단위 | marketplace.json에 16개 |
| 마켓플레이스 | 플러그인 목록을 담은 저장소 | 저장소 자체 |
흥미로운 건 marketplace.json에 등록된 16개 플러그인의 실제 소스가 이 저장소가 아니라 외부 저장소라는 점이다. 14개가 gemini-cli-extensions 소속이고 나머지는 GoogleCloudPlatform 계열이다. 같은 커밋에 코덱스용 목록도 따로 있는데 그쪽은 15개다.
이름만 보면 제미나이 CLI 확장을 클로드용으로 옮긴 것처럼 보이지만, 그렇게 단정하기는 이르다. 외부 저장소들이 클로드·코덱스·안티그래비티용 구조를 함께 담고 있어, 여러 도구를 동시에 지원하는 패키지에 가깝다.
5. 스킬 본문은 어떻게 생겼나
프론트매터는 에이전트 스킬 공개 표준 형식을 따른다. name과 description이 있고, 구글은 여기에 metadata.category를 덧붙였다. 클로드 코드는 이 표준 위에 호출 제어와 도구 권한 같은 확장을 얹는다.
---
name: cloud-monitoring-metric-selection
metadata:
category: CloudObservabilityAndMonitoring
description: >-
Retrieve, query, and identify relevant Google Cloud Monitoring metric
descriptors for a GCP service or resource ... Use when asked to find,
list, search, or discover GCP metric types ...
---설명문이 “무엇을 하는지”와 “언제 쓰는지”를 함께 담고 있다. 앤트로픽 문서가 권하는 형태다. 스킬을 직접 만들 계획이라면 이 저장소가 설명문 작성 예시집으로도 쓸 만하다.
allowed-tools로 특정 도구를 사전 승인해 둔 스킬은 104개 중 1개였다. 나머지는 별도의 사전 승인 없이 클로드 코드의 기본 권한 설정을 따른다. 이 키는 도구를 제한하는 장치가 아니라, 매번 묻지 않고 쓸 도구를 미리 지정하는 장치다.
클로드 코드 플러그인 설치 전 확인할 것
- 구글 클라우드를 실제로 쓰는지 먼저 답한다. 아니라면 90개는 볼 필요가 없다.
npx skills add google/skills에서 필요한 스킬만 선택한다. 마켓플레이스 추가는 카탈로그 등록일 뿐이므로, 이후 필요한 플러그인만 소스를 확인하고 개별 설치한다.- 설치 전후로 클로드 코드에서
/context를 찍어 비교한다. 추정하지 말고 내 환경에서 재는 것이 유일하게 확실하다. - 쓰지 않는 스킬은 지운다. 쓰지 않아도 활성 상태면 시작 목록에 들어갈 재료가 된다.
- 플러그인 16개는 소스가 외부 저장소다. 무엇을 받아오는지
marketplace.json에서 확인하고 설치한다.
같은 방식으로 다른 도구도 설치부터 실측까지 해본 기록이 있다. PDF를 클로드 코드 스킬로 바꾸는 도구에서는 고정 비용 때문에 장이 짧으면 손해가 났고, 코덱스 디자인 플러그인에서는 문서가 안내하는 설치 경로가 막혀 있었다.
누가 쓰면 좋은가
쓸 만한 경우. 구글 클라우드에서 실제로 작업하는 사람, 특히 GKE 추론이나 에이전트 플랫폼 운영처럼 명령이 길고 문서를 자주 뒤져야 하는 영역이다. 구글 애즈나 모바일 애즈 SDK를 다루는 경우도 해당한다.
건너뛰어도 되는 경우. GCP를 직접 운영하지 않는다면 실무 활용 범위는 제한적이다. 다만 아키텍처 설계나 검토 체크리스트가 필요할 때 참고할 스킬은 일부 있다. 그리고 “구글이 냈으니 일단 깔고 보자”는 가장 나쁜 선택이다. 쓰지 않을 90개를 활성 상태로 두는 셈이고, 그만큼 시작 목록이 불필요하게 길어진다.
자주 묻는 질문
클로드 코드 플러그인은 무료인가
이 저장소는 아파치 2.0 라이선스로 무료다. 다만 스킬이 안내하는 구글 클라우드 서비스 자체는 별도 과금 대상이다.
104개를 다 깔면 정말 느려지나
속도보다 컨텍스트 문제에 가깝다. 다만 “몇 개면 몇 토큰”처럼 딱 떨어지지 않는다. 목록에는 예산이 있어 넘치면 설명이 축약될 수 있고, 설정으로 특정 스킬의 비용을 없앨 수도 있다. 내 환경에서 얼마나 드는지는 /context로 재는 것이 유일하게 확실한 방법이다.
코덱스나 다른 도구에서도 되나
README가 클로드 코드, 코덱스, 안티그래비티 CLI 설치 명령을 각각 제공한다. 에이전트 스킬이 공개 표준이라 형식이 같기 때문이다.
플러그인과 스킬 중 뭘 설치하는 건가
클로드 코드 플러그인 설치 명령(claude plugin install)과 스킬 설치 명령(npx skills add)은 대상이 다르다. 이 저장소에는 둘 다 있고 성격도 다르다. 스킬 104개는 저장소 안에 있고, 플러그인 16개는 외부 저장소를 가리킨다.
직접 스킬을 만들 때 참고가 되나
설명문 작성 예시로는 쓸 만하다. 104개가 “무엇을 하는지 + 언제 쓰는지” 형식을 일관되게 지킨다. 다만 본문 평균이 1만 자를 넘어 짧게 쓰는 참고서로는 맞지 않는다.
설치한 스킬은 어떻게 지우나
스킬은 폴더 단위라 해당 디렉터리를 지우면 된다. 플러그인은 클로드 코드의 플러그인 관리 명령으로 제거한다. 지운 뒤 /context로 시작 토큰이 줄었는지 확인하는 편이 확실하다.
확인하지 못한 것
클로드 코드 플러그인 저장소의 구조와 분량은 직접 세어 확인했다. 스킬을 실제로 설치해 GCP 작업을 수행한 결과는 검증하지 않았다. 구글 클라우드 계정과 과금이 필요한 작업이 대부분이기 때문이다. 스킬이 실제로 얼마나 정확하게 동작하는지, 문서가 최신인지는 따로 확인해야 한다. /context 실측치도 이 글에는 넣지 않았다.
출처
- 저장소: google/skills (커밋 092e210, 2026-08-07)
- 스킬 형식과 로딩 방식: Agent Skills 공식 문서
- 스킬 로딩·목록 예산·도구 권한: Claude Code 스킬 문서
- 마켓플레이스 등록·설치·비활성화: Claude Code 플러그인 문서
최종 확인 2026년 8월 10일. 저장소가 활발히 개발 중이라 스킬 개수와 구성은 바뀔 수 있다. 다만 활성 스킬이 늘어날수록 시작 목록이 길어진다는 구조는 바뀌지 않으므로, 골라 설치하고 /context로 확인하라는 결론도 유지된다. 다음 점검은 2026년 11월 예정.
