나만의 커스텀 에이전트 스킬 제작 가이드: 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. 요약: 나만의 에이전트 스킬 라이브러리를 구축하라

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