작은 스킬 창고

제미나이 CLI에 스킬 설치하는 방법

제미나이 CLI는 2026년에 SKILL.md 형식을 지원하기 시작해서, 클로드 코드·커서용으로 만든 스킬이 구글의 터미널 에이전트에서도 동작합니다. 설치 명령, 제미나이 CLI가 읽는 폴더, 확인과 다시 불러오기용 /skills 명령, 스킬이 안 보일 때 할 일을 정리했습니다.

창고 사용 안내서

명령어

Node.js 18 이상이 있는 터미널에서 실행하세요. 제미나이 CLI 자체가 Node 20을 요구하니 이미 충족합니다. --agent gemini-cli는 설치를 제미나이 폴더로 보내고, -y는 기본값을 받아들입니다. 소유자, 저장소, 스킬 이름은 이 사이트의 스킬 페이지에서 복사하세요.

에이전트 id는 하이픈이 있는 gemini-cli입니다. --agent gemini는 인식되지 않아 CLI가 대화형 선택 화면으로 돌아갑니다.

npx skills add anthropics/skills@frontend-design --agent gemini-cli -y

전역 설치와 프로젝트 설치

-g를 붙이면 스킬이 ~/.gemini/skills/<이름>/에 쓰이고 모든 디렉터리에서 쓸 수 있습니다. 없으면 현재 저장소의 .agents/skills/<이름>/에 들어가며 팀을 위해 커밋할 수 있습니다. 제미나이 CLI는 프로젝트 안의 .gemini/skills/도 읽는데, 직접 복사하는 스킬은 여기에 두면 됩니다.

이름이 같으면 프로젝트 스킬이 전역 스킬보다 우선하므로 저장소가 개인 기본값을 덮어쓸 수 있습니다. 구분은 단순하게 두세요. 검토와 형식 규칙은 전역, 프레임워크 전용 스킬은 프로젝트.

npx skills add anthropics/skills@frontend-design --agent gemini-cli -g -y

# Global:  ~/.gemini/skills/frontend-design/SKILL.md
# Project: .agents/skills/frontend-design/SKILL.md

제미나이 CLI가 불러왔는지 확인

gemini 세션 안에서 /skills list를 입력하면 발견된 모든 스킬이 설명과 활성 여부와 함께 나옵니다. 세션이 열린 상태로 설치했다면 /skills reload로 재시작 없이 폴더를 다시 훑습니다. /skills가 인식되지 않으면 npm install -g @google/gemini-cli@latest로 갱신하세요. 2026년 초 릴리스에서는 스킬이 실험 설정 뒤에 있었고 이 명령도 없었습니다.

/skills disable <이름>은 지우지 않고 스킬을 끄고, /skills enable <이름>은 다시 켭니다. 스킬이 도움이 되는지 시험하는 가장 쉬운 방법입니다. 끄고, 같은 요청을 반복하고, 비교하세요.

gemini
/skills list
/skills reload

스킬 사용

제미나이 CLI는 세션 시작 시 설치된 스킬의 이름과 설명을 읽고, 요청이 맞으면 SKILL.md 전체를 활성화합니다. 특정 스킬을 꼭 쓰게 하려면 요청에 이름을 넣으세요. "frontend-design 스킬을 써서 설정 페이지를 만들어 줘". 스킬용 슬래시나 달러 문법은 없고 평문으로 이름을 쓰면 됩니다.

GEMINI.md는 다릅니다. 매 턴 상시 컨텍스트로 읽힙니다. 짧고 항상 참인 규칙은 거기에, 긴 절차는 스킬에 두어 필요할 때만 토큰이 들게 하세요.

갱신과 삭제

npx skills update는 CLI가 설치한 모든 것을 갱신합니다. 삭제하려면 ~/.gemini/skills/나 프로젝트의 .agents/skills/에서 폴더를 지우고 /skills reload를 실행하거나 새 세션을 시작하세요.

npx skills update

안 될 때

/skills list에 없다: 먼저 /skills reload를 실행하세요. 그래도 없으면 SKILL.md가 스킬 폴더 최상위에 있고(한 단계 더 깊지 않게) 머리말에 name과 description이 있는지 확인하세요. 제미나이 CLI는 머리말이 읽히지 않는 폴더를 무시합니다.

엉뚱한 폴더에 설치됐다: --agent gemini-cli 없이 실행하면 CLI가 ~/.agents/skills/나 다른 에이전트 폴더에만 쓸 수 있습니다. 옵션을 붙여 다시 설치하거나 폴더를 ~/.gemini/skills/로 옮기세요.

목록에는 있는데 활성화되지 않는다: 내 말과 설명이 대조됩니다. 스킬 페이지의 설명을 읽고 그 표현을 쓰거나 요청에 스킬 이름을 넣으세요. 저희 색인에서 설명이 빈 스킬은 이름을 불러야만 동작합니다.

스크립트가 있는 스킬: 제미나이 CLI는 승인하지 않은 셸 명령을 실행하기 전에 묻습니다. 스크립트가 파이썬이나 npm 패키지를 요구하는 스킬은 그 질문에서 멈춥니다. 설치 전에 스킬 페이지에서 스크립트 폴더를 읽고 필요한 것을 직접 설치하세요.

윈도우: Node.js가 PATH에 있는 PowerShell이나 Git Bash를 쓰세요. 전역 설치가 심볼릭 링크 권한 오류로 실패하면 윈도우 설정에서 개발자 모드를 켜거나 관리자 터미널에서 한 번 실행하세요.

자주 묻는 질문

클로드 코드용 스킬이 제미나이 CLI에서 되나요?

마크다운만 있는 스킬은 그대로 됩니다. 클로드 코드의 하위 에이전트나 슬래시 명령을 언급하는 스킬은 제미나이 CLI에 없는 기능을 설명하지만 나머지 지침은 적용됩니다.

스킬과 제미나이 CLI 확장은 같은 건가요?

아닙니다. 확장은 MCP 서버, 명령, 컨텍스트 파일을 묶은 패키지로 gemini extensions install로 설치합니다. 스킬은 지침 폴더 하나입니다. 확장 안에 스킬이 들어갈 수 있습니다.

--agent를 빼면 CLI가 어디에 설치하나요?

어느 에이전트에 설치할지 묻고 각 폴더에 씁니다. 선택 화면에서 제미나이 CLI를 고르거나 옵션을 넘겨 질문을 건너뛰세요.

쓰지 않는 스킬도 토큰을 쓰나요?

이름과 설명만 세션당 한 번 읽습니다. 전체 파일은 활성화될 때 올라옵니다.

제미나이 CLI, 코덱스, 클로드 코드에서 스킬을 공유할 수 있나요?

네. --agent 없이 설치해 셋 다 고르거나, 셋 모두 읽는 프로젝트의 .agents/skills/에 설치하세요.

내용 최종 확인일: 2026-09-03