SKILL.md 사양 가이드 (Specification)

SKILL.md 파일은 스킬의 핵심 정의서이며, YAML Frontmatter와 Markdown 본문으로 구성됩니다.

1. YAML Frontmatter

파일의 맨 윗부분에 위치하며, 에이전트가 스킬을 식별하고 활성화하는 데 필요한 메타데이터를 담습니다.

---
name: code-review-expert
description: 사용자가 코드 리뷰를 요청하거나 풀 리퀘스트를 생성할 때 활성화하십시오. 전문적이고 상세한 코드 리뷰 가이드라인을 제공합니다.
version: 1.0.0
author: Gemini CLI Team
tags: [coding, review, quality]
---

name: 스킬의 고유 식별자.
description: 가장 중요한 부분입니다. 에이전트가 “언제 이 스킬을 써야 하는지”를 판단하는 기준이 됩니다. 구체적으로 작성할수록 정확한 타이밍에 활성화됩니다.

2. Markdown 본문

에이전트가 스킬을 활성화했을 때 따르게 될 구체적인 지침입니다.

구성 요소

지시사항 (Instructions): 에이전트가 해당 스킬을 사용하여 수행할 단계별 작업 지침.
제약 조건 (Constraints): 반드시 지켜야 할 규칙이나 하지 말아야 할 행동.
예시 (Examples): 이상적인 수행 결과물에 대한 예시.
참조 (References): 스킬 폴더 내의 다른 파일들을 어떻게 활용해야 하는지 명시.

3. 작성 팁

명확한 명령조 사용: “리뷰할 때는 코드가 깨끗한지 확인하세요”보다는 “코드의 가독성, 명명 규칙, 잠재적 버그를 단계별로 검증하십시오”와 같이 명확한 행동 위주로 서술합니다.
도구 결합: 이 스킬을 사용할 때 함께 쓰면 좋은 MCP 도구나 스크립트를 언급하여 에이전트의 도구 활용을 유도합니다.
결과물 형식 지정: 에이전트가 출력할 결과물의 포맷(JSON, Markdown Table 등)을 미리 정의해두면 일관된 결과를 얻을 수 있습니다.