스킬

uvx로 agents-cli를 설치해 코딩 Agent에 Gemini 플랫폼 스킬 더하기

Gemini Enterprise Agent Platform에서 Agent를 만들고 기존 코딩 도우미에 공식 CLI와 스킬을 설치하려는 사람에게 맞다. 전제는 Python 3.11+, uv, Node.js가 있는 것이다.

Official source · agents-cli

Install

uvx google-agents-cli setup

누구에게 맞나

이 가이드는 Gemini Enterprise Agent Platform에서 Agent를 만들고, 공식 CLI와 스킬을 기존 코딩 도우미에 넣고 싶은 사람을 위한 것이다. 저장소는 해당 플랫폼에서 Agent를 만들기 위한 CLI와 skills로 적혀 있다.

시작 전에 세 가지 전제가 모두 갖춰졌는지 확인하라: Python 3.11+, uv, 그리고 Node.js. 하나라도 없으면 설치를 실행하지 마라. 페이지는 Antigravity CLI, Claude Code, Codex 및 그 외 어떤 coding agent와도 함께 쓸 수 있다고 적는다. 이는 호환 설명이지 배타 목록이 아니며, uvx 설치를 나타나지 않은 마켓 설치로 일반화하지 마라.

agents-cli setup의 역할은 CLI를 설치하고 skills를 coding agents에 넣는 것이다. 첫 시도는 설치와 읽기 전용 확인만 마치고, 이름 없는 온라인 Agent를 배포하거나 평가하지 마라.

3분 안에 첫 시도 완료하기

페이지가 제시한 권장 설치 명령만 사용한다.

uvx google-agents-cli setup

전제 조건: 이 기기에 이미 Python 3.11+, uv, Node.js가 있고, 지금 쓰는 coding agent에 CLI와 스킬을 쓸 준비가 되어 있어야 한다. 설치 위치는 setup이 이들 Agent에 쓰는 곳이며, 해당 페이지에 없는 다른 경로가 아니다.

부작용 확인 지점: 이 명령은 CLI를 설치하고 skills를 coding agents에 넣는다. 현재 환경이 바꾸려는 Agent가 아니거나, 세 전제를 아직 다 확인하지 않았다면 먼저 멈춰라. 확인한 뒤에 실행한다.

성공 신호: 명령이 정상 종료되고, 해당 Agent에서 새로 넣은 스킬 또는 사용 가능한 CLI를 볼 수 있다. 이어서 확인만 한다. 호환 Agent에서 해당 스킬 설명을 열고 Gemini Enterprise Agent Platform 관련 스킬을 인식하는지 확인하라. 클라우드 Agent를 만들거나, 평가하거나, 배포하지 마라. 마법사가 배포로 이어가려 하면 확인 지점에서 멈춰라.

사용 사례

사례 1: 공식 명령으로 CLI와 스킬 설치를 마친다. 먼저 Python 3.11+, uv, Node.js를 쓸 수 있는지 확인한 뒤 uvx google-agents-cli setup을 실행한다. 근거가 다루는 것은 이 설치 명령과, agents-cli setup이 “Install CLI + skills to coding agents”한다는 점이다. 완료 기준은 설치 성공과 Agent가 스킬을 보는 것까지다. 나타나지 않은 업그레이드나 제거 명령을 보태지 마라.

사례 2: 설치 후 읽기 전용 인식 확인을 하고 온라인에 올리지 않는다. 페이지는 이 도구를 Gemini Enterprise Agent Platform에서 Agent를 만드는 CLI와 skills로 위치시키고, Antigravity CLI, Claude Code, Codex 및 다른 coding agent와 함께 쓸 수 있다고 나열한다. 발췌에는 생성이나 배포 명령이 없으므로, 첫 번째는 스킬이 이미 설치된 Agent 하나에서 스킬이 로드되었는지만 확인한다. 관찰 가능한 성공 신호는 스킬 설명이 보이는 것이다. “and any other coding agent”를 이름 없는 환경마다 검증된 설치가 있다는 뜻으로 읽지 마라.

사용 경계

주 설치 경로는 uvx google-agents-cli setup뿐이다. Python 3.11+, uv 또는 Node.js가 없으면 설치하지 마라. 나열된 Agent는 유일한 지원 범위가 아니다. setup은 Agent 쪽 스킬 파일을 바꾸며, 배포와 평가는 이번 발췌의 명령에 없다. 적히지 않은 경로와 권한을 안전 결론으로 삼을 수 없다.