GitHub - google-gemini/gemini-skills: Skills for the Gemini API, SDK and model/agent interactions
Service

GitHub - google-gemini/gemini-skills: Skills for the Gemini API, SDK and model/agent interactions

google-gemini
2026.04.02
·GitHub·by 이호민/AI
#Agent#Gemini API#LLM#Skills#Vertex AI

핵심 포인트

  • 1이 `gemini-skills` 저장소는 빠르게 변화하는 소프트웨어 개발 환경에서 LLM의 지식 격차를 해소하기 위해 Gemini API 상호작용을 위한 'Skills' 라이브러리를 제공합니다.
  • 2이 Skills는 Gemini API 기반 앱 개발, Vertex AI 연동, 실시간 스트리밍, 그리고 상호작용 API 사용에 대한 모범 사례와 컨텍스트를 제공하여 개발을 돕습니다.
  • 3본 Skill을 추가함으로써 에이전트가 올바른 API 코드를 생성하는 능력이 최대 96%까지 향상되어, Gemini 모델의 성능과 유용성을 크게 개선합니다.

본 문서는 Google Gemini의 gemini-skills GitHub 저장소에 대한 설명으로, 대규모 언어 모델(LLM)이 훈련 시점의 고정된 지식으로 인해 발생하는 최신 정보 격차를 해소하기 위한 "skills" 라이브러리를 소개합니다. 소프트웨어 개발은 빠르게 변화하며 새로운 라이브러리가 매일 출시되고 모범 사례가 끊임없이 진화하기 때문에, LLM은 스스로에 대한 지식, 미묘한 모범 사례(예: "thought circulation")의 변화, 또는 SDK 업데이트 사항을 알 수 없는 지식 격차(knowledge gap)에 직면합니다.

이러한 문제를 해결하기 위해 "skills"는 에이전트(agent)에 관련 컨텍스트(context)를 추가하는 경량 기술(lightweight technique)로 제안됩니다. 이는 LLM이 최신 정보를 기반으로 정확한 API 코드를 생성하고 모범 사례를 따를 수 있도록 지원하는 핵심 방법론입니다. 저장소에 포함된 skills는 특히 Gemini API 기반 애플리케이션 개발에 중점을 둡니다.

제공된 평가에 따르면, 이 skill을 추가함으로써 에이전트의 올바른 API 코드 생성 능력 및 모범 사례 준수 능력이 크게 향상되었습니다. 구체적으로 Gemini 3 Flash 모델에서는 87%, Gemini 3 Pro 모델에서는 96%의 성능 향상을 보였습니다.

제공되는 주요 skill들은 다음과 같습니다:

  • gemini-api-dev: Gemini 기반 애플리케이션 개발을 위한 skill로, Gemini API를 사용하는 앱 구축에 필요한 모범 사례(best practices)를 제공합니다.
  • vertex-ai-api-dev: Google Cloud Vertex AI 환경에서 Gen AI SDK를 사용하여 Gemini 기반 애플리케이션을 개발하기 위한 skill입니다. 이는 도구(tools), 다중 모달 생성(multimodal generation), 캐싱(caching), 그리고 배치 예측(batch prediction) 등의 주제를 다룹니다.
  • gemini-live-api-dev: Gemini Live API를 활용하여 실시간(real-time), 양방향 스트리밍(bidirectional streaming) 애플리케이션을 구축하기 위한 skill입니다. 이 skill은 WebSocket 기반의 오디오/비디오/텍스트 스트리밍, 음성 활동 감지(voice activity detection), 네이티브 오디오 기능, 함수 호출(function calling), 그리고 세션 관리(session management)를 포함합니다.
  • gemini-interactions-api: Gemini Interactions API를 사용하여 애플리케이션을 구축하기 위한 skill입니다. 텍스트 생성, 다중 턴 채팅(multi-turn chat), 스트리밍, 함수 호출, 구조화된 출력(structured output), 이미지 생성, Deep Research agents, deprecated 모델 가드레일(guardrails) 등을 다루며, Python 및 TypeScript SDK를 모두 지원합니다.

skill은 Vercel skills CLI 또는 Context7 skills CLI를 통해 설치할 수 있습니다. 예를 들어 Vercel skills CLI를 사용하여 대화형으로 skill을 찾아 설치하거나 (npx skills add google-gemini/gemini-skills --list), 특정 skill을 설치할 수 있습니다 (npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global). Context7 skills CLI도 유사한 방식으로 동작합니다 (npx ctx7 skills install /google-gemini/gemini-skills 또는 npx ctx7 skills install /google-gemini/gemini-skills vertex-ai-api-dev).

본 프로젝트는 공식적으로 지원되는 Google 제품이 아니며, Google Open Source Software Vulnerability Rewards Program의 대상이 아님을 명시하고 있습니다.