Agent Skills 설계: 반복 업무를 재사용 가능한 AI 작업으로 만들기

스킬은 반복 작업의 절차와 자료를 묶는 방식입니다

Agent Skills 명세는 SKILL.md의 이름과 설명, 본문 지침 및 선택적인 스크립트·참고 자료 구성을 정의합니다. 필요한 시점에 상세 정보를 불러오는 방식도 설명합니다. 팀에서는 릴리스 노트 작성, 데이터 검수나 보고서 정리처럼 반복되지만 매번 입력이 달라지는 작업부터 적용해 볼 수 있습니다.

예를 들어 '주간 보고서 작성'이라는 이름만 있으면 회의 메모 요약과 프로젝트 현황 보고를 구분하기 어렵습니다. '이슈 목록과 작업 기록을 받아 완료·지연·결정 필요 항목이 있는 주간 프로젝트 보고서를 만든다'처럼 입력과 결과를 설명하면 적절한 작업에 연결하기 쉽습니다.

입력과 결과물을 먼저 고정합니다

핵심 절차는 짧게, 상세 자료는 필요할 때 읽게 합니다

본문에는 작업 순서와 중요한 판단 기준을 남깁니다. 긴 템플릿, 특정 고객의 예시, 파일 형식 설명은 별도 자료로 나누고 언제 읽어야 하는지 연결하세요. 파일을 나눈 것만으로 충분하지 않습니다. 실행 환경에서 참조 경로가 실제로 열리고 필요한 라이브러리를 사용할 수 있어야 합니다.

여러 스킬이 같은 요청에 동시에 반응하면 도구가 잘못 선택할 수 있습니다. 설명에 대상 업무와 제외 범위를 구체적으로 적고, 프로젝트 전반에 적용할 규칙은 저장소 지침에 둡니다. 스킬을 실행할 때마다 공통 지침을 복제하면 정책 변경 시 서로 다른 내용이 남기 쉽습니다.

성공 예시 외에 입력이 부족한 경우도 확인합니다

실제 보고서가 아닌 가상의 이슈 목록으로 초안을 만들고 담당자가 검수해 보세요. 누락된 날짜, 중복 이슈, 서로 다른 상태가 들어온 경우도 확인합니다. 스킬에 스크립트가 포함된다면 생성 결과를 다시 읽는 검증이 필요하며, 외부 시스템에 쓰는 작업은 실행 권한과 대상이 따로 통제되어야 합니다.

팀 공유 전 확인할 항목

• 설명만 읽어도 사용 조건과 결과물을 알 수 있는가
• 필수 입력이 없을 때 임의로 채우지 않는가
• 참고 파일과 실행 환경이 함께 준비되어 있는가
• 스크립트나 외부 연결의 권한 범위가 명확한가
• 변경 버전별 대표 예시를 다시 검수할 수 있는가