코딩 에이전트에게 Gemini API 코드를 시키면, 높은 확률로 틀린 코드가 나온다.
모델명이 틀리고, SDK가 deprecated된 거고, 베스트 프랙티스도 옛날 것이다.
왜냐? 얘들은 학습 시점 이후의 세상을 모르니까.
그래서 구글이 하나 만들었다. gemini-skills라는 걸.
그래서 Skills가 뭔데.
한 줄 요약: 코딩 에이전트의 컨텍스트에 "최신 Gemini API 가이드"를 주입하는 문서 모음이다.
LLM은 학습 시점에 고정된 지식만 가지고 있다. 근데 Gemini API는? 얼마 전까지 2.0이 쓸 수 있었는데,
지금은 2.0도 곧 deprecated된다는 알림이 오고 있다.
3.x 시리즈로 넘어가는 중이고, SDK도 바뀌었고, Interactions API라는 새로운 인터페이스도 생겼다.
이 속도를 LLM이 따라갈 리가 없다. 웹검색을 시켜서 만들라고 해도 간단한 분석이라며 에이전트 모델을 gemini-1.5 로 잡아버리더라.
gemini-Skills는 이 갭을 메운다.
Claude Code든 Gemini CLI든 Cursor든, 코딩 에이전트가 코드를 생성하기 전에
"이 모델은 deprecated야, 이 SDK를 써야 해, 이 패턴이 현재 베스트 프랙티스야"라고 인식할 수 있게 해준다는거.
맞다. 이미 claude에서 skill을 사용해보았다면 알 수 있는, 그냥 별다를거 없는 skill이다.
GitHub: google-gemini/gemini-skills
효과가 있긴 한 거야?
당연하게도 있다고 한다. 꽤 극적으로.
구글이 117개 프롬프트로 평가를 돌렸는데,
스킬 없이 Gemini 3.0 Pro/Flash → 6.8% 정답률
스킬 있으면 Gemini 3 Flash → 87%, Gemini 3.1 Pro → 96%
6.8%에서 96%.
14배 차이다.
검색해서 나오는 구버전 블로그 글 참고해서 deprecated 코드 짜는 것과, 최신 레퍼런스 보고 바로 올바른 코드 짜는 것의 차이가 이 정도라는 얘기다.
포함된 스킬은 4개
1. gemini-api-dev (핵심)
Gemini API로 앱 빌드할 때의 기본 스킬. 멀티모달, 함수 호출, 구조화된 출력 등을 다룬다.
Python, JavaScript/TypeScript, Java, Go 네 가지 SDK를 커버한다.
핵심은 이 규칙이다:
"gemini-2.0-*, gemini-1.5-* 같은 모델은 레거시이고 deprecated이니 절대 사용하지 마라. 너의 학습 데이터는 outdated 되었으니 이 섹션을 신뢰하라."
LLM에게 "너 옛날 지식이야, 이거 참고해"라고 못 박아버리는 거다.
2. gemini-live-api-dev
WebSocket 기반 실시간 양방향 오디오/비디오/텍스트 스트리밍 앱용. 음성 활동 감지(VAD), 네이티브 오디오 등을 다룬다.
3. gemini-interactions-api
Gemini의 새로운 통합 인터페이스인 Interactions API용. 기존 generateContent의 개선판
서버사이드 상태 관리, 백그라운드 실행, SSE 스트리밍 등 에이전틱 앱을 위한 기능들을 커버한다.
4. vertex-ai-api-dev
Google Cloud Vertex AI에서 Gen AI SDK로 개발할 때 쓰는 스킬. 멀티모달 생성, 캐싱, 배치 예측 등.
내가 이걸 어디에 쓸 수 있나
이건 AI 기능을 만드는 코드를 짤 때 쓰는 거다.
이런 경우에는 직빵이다:
"우리 앱에 이미지 분석해서 일정 추출하는 AI 기능 넣어줘" → Gemini 멀티모달 API 호출
"실시간 음성 대화 기능 만들어줘" → Gemini Live API 연동
"AI 챗봇 기능 넣어줘" → Gemini API 호출 코드 생성
예를 들어 Vertex AI로 이미지와 텍스트에서 일정을 AI로 분석하는 iOS 앱이 있다고 하자. 이걸 Android 버전으로 새로 만들어야 할 때,
Claude Code에 vertex-ai-api-dev 스킬을 설치해놓고 "이거 Android로 만들어줘"라고 시키면?
스킬 없이 시키면 구버전 SDK와 deprecated 모델명으로 코드가 나올 확률이 높지만, 스킬이 있으면 최신 SDK, 최신 모델명, 현재 베스트 프랙티스대로 정확한 코드가 나온다.
같은 프롬프트. 다른 결과.
결론
Gemini API처럼 빠르게 변하는 기술 영역에서, 코딩 에이전트가 웹 검색으로 가져온 정보는 이미 낡았을 수 있다.
구글 gemini github이 공개한 이 Skills는 "검색해서 레거시 적용하고 낭패 보는" 루프를 끊어주는 장치다.
아, 단점.
gemini-2.5-flash처럼 아직 사용 가능하고 저렴한 모델로 충분한 서비스인데도,
코딩 에이전트가 무조건 gemini-3-flash-preview나 gemini-3.1-pro-preview 같은 더 비싼 최신 모델로 코드를 짜버리는 상황이 생길 수 있다.
AI와 스킬 분석 끝. 이제 이걸로 내 앱을 어떻게 바꿔줄지 돌려봐야지.