나만의 커스텀 에이전트 스킬 제작 가이드: SKILL.md 프론트매터 및 구조 설계

기존에 제공되는 스킬 모듈을 뛰어넘어, 내 업무 현장의 독자적인 업무 컨벤션이나 독자 도구를 위한 **나만의 에이전트 커스텀 스킬(Custom Agent Skill)**을 개발하는 방법은 생각보다 매우 단순하고 명확합니다. 에이전트 스킬을 제작하는 템플릿과 정밀 표준 규격을 가이드합니다.

1. 커스텀 스킬 디렉토리 및 파일 구조 표준

스킬 루트 경로(`.agents/skills/my_custom_skill/`) 하위의 모듈 구조입니다.

• `SKILL.md` (필수): 스킬 정의 프론트매터 및 메인 지침 문서. (500라인 이내 권장)
• `scripts/` (선택): 스킬 실행을 돕는 파이썬/쉘 실행 스크립트 모음.
• `resources/` & `references/` (선택): 500라인 이상의 거대한 참고 가이드 문서나 이미지/템플릿 자원.

2. SKILL.md 작성 표준 예시 템플릿

---
name: my_domain_expert_skill
description: 특정 프로젝트 컨벤션이나 사내 전용 도구를 사용해 빌드 및 테스트를 수행할 때 이 스킬을 호출합니다.
---

# 사내 전문 도구 스킬 가이드

## 작업 전 규칙
- 1. 항상 .env 파일의 내역을 확인합니다.
- 2. scripts/build_helper.py 스크립트를 사용하여 빌드 검증을 진행합니다.

## 예외 처리
- 빌드 에러 발생 시 references/error_dictionary.md 문서를 참고합니다.

"잘 만들어진 커스텀 스킬 하나는 팀 전체 개발자의 숙련도를 일괄 상향 평준화시키는 최고의 지식 자산입니다."

3. 스킬 등록 및 자동 패치(Auto-discovery) 원리

스킬을 표준 커스텀 루트 경로(`skills/`)에 생성해 두면 에이전트 시스템은 별도의 설정 없이 자동으로 스킬을 감지(Auto-discovery)하고 필요할 때 트리거합니다.

4. 요약: 나만의 에이전트 스킬 라이브러리를 구축하라

오늘부터 자주 반복되는 본인만의 노하우를 커스텀 스킬 문서로 템플릿화하여 에이전트의 강력한 무기로 만들어 보세요.