Agent Skill

 

1. Skill 일반

에이전트 스킬을 직접 생성하려면 스킬 디렉터리를 만들고 그 안에 SKILL.md 파일을 작성해야 합니다. 이 파일은 에이전트가 언제 스킬을 사용해야 하는지 판단하는 메타데이터와 실제 수행해야 할 지침을 담고 있습니다.

제공된 소스를 바탕으로 스킬 생성 및 SKILL.md 작성법을 단계별로 설명해 드리겠습니다.

1. 스킬 디렉터리 및 위치

스킬은 하나의 독립된 디렉터리(폴더)로 구성됩니다. 스킬을 생성할 위치는 사용 범위에 따라 두 곳 중 하나를 선택할 수 있습니다:

• 작업 공간 스킬 (Workspace Skills): .gemini/skills/ (해당 프로젝트 팀원과 공유)

• 사용자 스킬 (User Skills): ~/.gemini/skills/ (모든 작업 공간에서 개인이 사용)

기본 폴더 구조는 다음과 같습니다,:

my-skill/                 # 스킬 폴더 이름
├── SKILL.md              # (필수) 지침 및 메타데이터
├── scripts/              # (선택) 실행 가능한 스크립트 도구
├── references/           # (선택) 정적 문서 및 예제
└── assets/               # (선택) 템플릿 및 바이너리 리소스

2. SKILL.md 작성법

SKILL.md 파일은 **YAML 프런트매터(Frontmatter)**와 Markdown 본문으로 구성됩니다.

(1) YAML 프런트매터 (메타데이터)

파일의 맨 윗부분에 ---로 감싸서 작성하며, 다음 두 가지 필드가 필수입니다:

• name: 스킬의 고유 식별자입니다. 소문자, 숫자, 대시(-)만 사용해야 합니다.

• description: 가장 중요한 필드입니다. Gemini는 이 설명을 보고 현재 사용자의 요청에 이 스킬이 필요한지 자율적으로 판단합니다. 스킬이 제공하는 전문 지식이 무엇인지 구체적으로 적어야 합니다.

(2) Markdown 본문 (지침)

두 번째 --- 아래에 작성되는 내용은 모델이 스킬을 활성화했을 때 따르는 전문적인 절차나 가이드라인이 됩니다.

3. 작성 예시: 코드 리뷰어 (Code Reviewer)

다음은 소스에 소개된 코드 리뷰 스킬의 SKILL.md 작성 예시입니다,,.

---
name: code-reviewer
description:
  코드의 스타일, 보안, 성능을 검토하는 전문 지식입니다. 사용자가 "피드백", "리뷰"를 요청하거나
  변경 사항을 "확인"해 달라고 할 때 사용하세요.
---

# Code Reviewer

당신은 전문 코드 리뷰어입니다. 코드를 리뷰할 때는 다음 워크플로를 따르세요:

1. **분석 (Analyze)**: 스테이징된 변경 사항이나 제공된 파일을 검토하세요. 변경 사항이 적절한
   범위를 가지며 문제를 해결하기 위한 최소한의 변경인지 확인하세요.

2. **스타일 (Style)**: 코드가 `GEMINI.md` 파일에 기술된 작업 공간의 규칙과 관용적 패턴을
   따르는지 확인하세요.

3. **보안 (Security)**: 잠재적인 보안 취약점을 표시하세요.

4. **테스트 (Tests)**: 새로운 로직에 대한 테스트 커버리지 유무와, 테스트가 변경 사항을
   적절히 검증하는지 확인하세요.

피드백은 "강점"과 "개선 기회"로 나누어 간결한 글머리 기호 목록으로 제공하세요.

4. 추가 리소스 활용 (선택 사항)

단순한 지침 외에 스크립트나 데이터가 필요한 경우, 스킬 디렉터리 내에 다음 폴더들을 추가할 수 있습니다. 스킬이 활성화되면 에이전트는 이 폴더들의 트리 구조를 파악하고 내부 자산을 읽을 수 있게 됩니다,.

• scripts/: 에이전트가 실행할 수 있는 bash, python, node 스크립트 등을 넣습니다.

• references/: 에이전트가 참고할 정적 문서, 스키마, 예제 데이터 등을 넣습니다.

• assets/: 코드 템플릿, 보일러플레이트(boilerplate) 등을 넣습니다.

이렇게 작성된 스킬은 초기에는 이름과 설명만 로드되어 토큰을 절약하다가, Gemini가 필요하다고 판단할 때(activate_skill) 전체 내용과 리소스를 컨텍스트로 불러옵니다,,.

 

 

2. gemini skill 문서

https://geminicli.com/docs/cli/skills/

Agent Skills

 

3. claude skill을 gemini에서 사용하기

 

1. 클로드 스킬을 가져오는 방법

클로드의 스킬을 안티그래비티에서 사용하려면 다음의 단계를 거쳐야 합니다:

• 스킬 다운로드: 구글에서 'Claude Skills GitHub'을 검색하여 엔트로픽(Anthropic)의 공식 스킬 저장소에 접속한 뒤, 코드를 ZIP 파일로 다운로드합니다.

• 파일 복사 및 붙여넣기: 다운로드한 파일 중 'skills' 폴더 내의 콘텐츠를 안티그래비티 프로젝트 내의 .agent/skills 폴더에 복사하여 넣습니다.

• 스킬 확인: 안티그래비티의 에이전트 설정에서 복사한 스킬들이 정상적으로 인식되는지 확인합니다. 이렇게 하면 클로드에서만 가능했던 슬랙 GIF 생성, PDF/PPT 제작 등의 기능을 사용할 수 있게 됩니다

 

https://www.youtube.com/watch?v=hhkUXkjp66A