Gemini CLI용 에이전트 스킬을 만드는 방법

1. 소개

이 실습에서는 LLM에 맞춤 지식과 워크플로에 대한 액세스 권한을 제공하는 에이전트 기술을 만드는 방법을 알아봅니다. Gemini CLI에서 액세스할 수 있는 로컬 스킬로 만듭니다.

실습할 내용

좋아하는 항목에 대한 나만의 에이전트 스킬을 만드세요.
Gemini CLI를 사용하여 스킬을 쿼리합니다.
Firebase용 공식 에이전트 스킬을 설치하고 이를 사용하여 앱을 빌드하고 배포합니다.

학습할 내용

스킬을 구성하는 방법
SKILL.md 파일을 작성하는 방법
Gemini CLI로 로컬 스킬을 사용하는 방법

2. 프로젝트 설정

아직 Google 계정이 없다면 Google 계정을 만들어야 합니다.
- 직장 또는 학교 계정 대신 개인 계정을 사용하세요. 직장 및 학교 계정에는 이 실습에 필요한 API를 사용 설정하지 못하도록 하는 제한이 있을 수 있습니다.
Google Cloud 콘솔에 로그인합니다.
Cloud 콘솔에서 결제를 사용 설정합니다.
- 이 실습을 완료하는 데 드는 Cloud 리소스 비용은 미화 1달러 미만입니다.
- 이 실습이 끝나면 단계에 따라 리소스를 삭제하여 추가 요금이 발생하지 않도록 할 수 있습니다.
- 신규 사용자는 미화$300 상당의 무료 체험판을 사용할 수 있습니다.
새 프로젝트를 만들거나 기존 프로젝트를 재사용합니다.
- 프로젝트 할당량에 관한 오류가 표시되면 기존 프로젝트를 재사용하거나 기존 프로젝트를 삭제하여 새 프로젝트를 만드세요.

3. Cloud Shell 편집기 열기

이 링크를 클릭하여 Cloud Shell 편집기로 바로 이동합니다.
오늘 언제든지 승인하라는 메시지가 표시되면 승인을 클릭하여 계속합니다.
터미널이 화면 하단에 표시되지 않으면 다음을 실행하여 엽니다.
- 보기를 클릭합니다.
- 터미널을 클릭합니다.
터미널에서 다음 명령어를 사용하여 프로젝트를 설정합니다.
- 형식:
```
gcloud config set project [PROJECT_ID]
```
- 예:
```
gcloud config set project lab-project-id-example
```
- 프로젝트 ID를 기억할 수 없는 경우 다음 단계를 따르세요.
  - 다음 명령어를 사용하여 모든 프로젝트 ID를 나열할 수 있습니다.
```
gcloud projects list | awk '/PROJECT_ID/{print $2}'
```
다음 메시지가 표시되어야 합니다.
```
Updated property [core/project].
```
WARNING이 표시되고 Do you want to continue (Y/n)?이 표시되면 프로젝트 ID를 잘못 입력한 것일 수 있습니다. n를 누르고 Enter를 누른 후 gcloud config set project 명령어를 다시 실행해 보세요.

4. '좋아하는 것' 스킬 만들기

에이전트 스킬은 AI 에이전트에게 안내와 지식을 제공하는 SKILL.md 파일이 최소한 포함된 디렉터리입니다. 이 섹션에서는 Gemini CLI에 좋아하는 것을 알려주는 스킬을 만듭니다.

스킬을 저장할 디렉터리를 만듭니다.
```
mkdir -p ~/.gemini/skills/my-favorite-things
```
스킬에 사용할 새 SKILL.md 파일을 만들고 엽니다.
```
cloudshell edit ~/.gemini/skills/my-favorite-things/SKILL.md
```
cloudshell edit 명령어를 사용하면 터미널 위의 편집기에서 SKILL.md 파일이 열립니다.

SKILL.md 파일에 다음 콘텐츠를 추가합니다.

---
name: my-favorite-things
description: Information about my favorite things. Use this skill to answer questions about my favorite color, food, or programming language.
---

My favorite color is blue.
My favorite food is pizza.
My favorite programming language is Python.

If asked about one of my favorite things, please respond with the information provided above.

SKILL.md 파일 하나로 첫 번째 스킬을 만들었습니다. 이제 Gemini CLI에서 이 기술을 사용할 시간입니다.

5. Gemini CLI에서 스킬 사용

이제 스킬을 만들었으므로 Gemini CLI와 함께 사용할 수 있습니다. ~/.gemini/skills에 배치된 스킬은 Gemini CLI에서 자동으로 검색됩니다.

Cloud Shell에서 Gemini CLI 시작
```
gemini
```
일부 기본 설정을 수락하려면 Enter 키를 눌러야 할 수 있습니다.
Gemini가 컨텍스트 내에서 사용할 수 있는 스킬을 나열하도록 합니다.
```
/skills
```
사용 가능한 스킬 목록에 my-favorite-things이 표시됩니다.
좋아하는 색에 관해 Gemini에게 질문하기:
```
What is my favorite color?
```
Gemini CLI는 my-favorite-things 스킬을 사용하여 질문에 답변해야 합니다. 메시지가 표시되면 Gemini CLI가 스킬을 사용할 수 있도록 허용합니다.

출력에 Gemini CLI가 스킬을 사용하여 '파란색'이라고 대답한 것으로 표시되어야 합니다.

완료했습니다. Gemini CLI를 사용하여 스킬을 만들고 테스트했습니다.

세션을 종료할 준비가 되면 /quit를 입력한 다음 Enter를 눌러 Gemini CLI를 종료합니다.

6. Firebase용 에이전트 스킬 설치

자체 스킬을 만드는 것 외에도 다른 사용자가 만든 스킬을 설치할 수 있습니다. Firebase용 에이전트 스킬 (GitHub)은 Firebase 관련 지식, 안내, 워크플로를 포함한 이식 가능한 독립형 모듈입니다. AI 어시스턴트가 Firebase 권장사항을 이해하고 더 높은 정확도와 더 낮은 토큰 비용으로 복잡한 작업을 실행할 수 있도록 설계되었습니다.

터미널에서 skills CLI를 사용하여 Firebase용 모든 에이전트 스킬을 설치할 수 있습니다.

npx skills add firebase/agent-skills

이 명령어는 firebase-basics, firebase-auth-basics, firebase-firestore-basics, firebase-app-hosting-basics를 비롯한 스킬을 다운로드하고 설치하여 my-favorite-things 스킬과 함께 Gemini CLI에서 사용할 수 있도록 합니다.

Firebase용 에이전트 스킬에 대해 자세히 알아보려면 사용 가능한 스킬을 참고하세요.

7. Firebase용 에이전트 스킬 살펴보기

이제 Firebase용 에이전트 스킬이 설치되었으며 Gemini CLI에서 사용할 수 있습니다. Gemini CLI를 실행하고 /skills firebase를 입력하면 확인할 수 있습니다.

gemini

그런 다음 Gemini CLI에서 다음을 실행합니다.

/skills firebase

firebase-basics, firebase-auth-basics, firebase-firestore-basics, firebase-app-hosting-basics와 같이 설치된 Firebase 스킬 목록이 표시됩니다.

8. (선택사항) Firebase용 에이전트 스킬을 사용하여 애플리케이션 만들기 및 배포

이제 설치된 Firebase용 에이전트 기술을 사용하여 사용자 인증 및 데이터베이스가 있는 '할 일' 웹 애플리케이션을 만들고 Firebase App Hosting에 배포합니다.

아직 Gemini CLI에 있는 경우 /quit를 입력하여 종료합니다.
프로젝트의 새 디렉터리를 만들고 디렉터리로 이동합니다.
```
mkdir todo-app && cd todo-app
```
Google 계정을 사용하여 Firebase에 로그인합니다. 브라우저가 없는 Cloud Shell 또는 다른 환경에 있는 경우 --no-localhost 플래그를 사용합니다.
```
firebase login --no-localhost
```
안내에 따라 Firebase CLI를 승인합니다.
Gemini CLI를 시작합니다.
```
gemini
```

이제 Gemini에게 애플리케이션 코드를 생성해 달라고 요청합니다.

Generate HTML, CSS, and Javascript for a single page  application. It should use Google Sign-in with Firebase Authentication, and save tasks in Cloud Firestore for the signed-in user. A user should be able to add new tasks and see a list of their tasks.

Gemini는 index.html, style.css, script.js와 같은 파일을 생성해 달라고 요청할 수 있습니다. 허용합니다.

마지막으로 애플리케이션을 Firebase App Hosting에 배포합니다.
```
/firebase-app-hosting-basics deploy my web app to Firebase App Hosting.
```
프롬프트에 따라 앱 호스팅을 구성하고 배포를 완료합니다. 배포가 완료되면 라이브 애플리케이션의 URL이 표시됩니다.

9. 결론

축하합니다. 스킬을 만들고 Gemini CLI용 추가 스킬을 설치하는 방법을 알아보았습니다.

(선택사항) 정리

정리하려면 클라우드 프로젝트를 삭제하여 추가 요금이 청구되지 않도록 하면 됩니다.

원하는 경우 프로젝트를 삭제합니다.

gcloud projects delete $GOOGLE_CLOUD_PROJECT

cloudshell 디스크에서 불필요한 리소스를 삭제하는 것이 좋습니다. 다음과 같은 작업을 할 수 있습니다.

스킬 디렉터리를 삭제합니다.

rm -rf ~/.gemini/skills/my-favorite-things

경고 이 작업은 되돌릴 수 없습니다. 공간을 확보하기 위해 Cloud Shell의 모든 항목을 삭제하려면 전체 홈 디렉터리를 삭제하면 됩니다. 보관하려는 모든 항목이 다른 곳에 저장되어 있는지 확인하세요.
```
sudo rm -rf $HOME
```