Agent Skills 문서
지침과 스크립트, 리소스를 묶어 Claude에 도메인 전문성을 부여하는 모듈형 확장 방식의 공식 문서
한눈에 보기
공식 검증 2026년 8월 29일
- 프로토콜
- 웹 문서
- 인증
- 공개 문서 기준 별도 인증 없음
- 비용
- 무료 열람
- 제공 상태
- 공개
Use cases
이럴 때 이렇게 연결합니다
먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.
추천 구성 · Situation 01
지침·스크립트·참고자료를 어디까지 스킬에 넣고 언제 불러올지 구조를 정하기 어려운 설계 업무
- 어떤 어려움인가
- 반복 업무를 Agent Skill로 패키징하는 팀이 자주 마주치는 문제입니다. 구체적으로는 '지침·스크립트·참고자료를 어디까지 스킬에 넣고 언제 불러올지 구조를 정하기 어려운 설계 업무' 상황입니다.
- 이렇게 해결합니다
- Agent Skills 문서 단계에서는 공식 문서의 현재 계약과 제한을 먼저 대조합니다. 입력 범위는 '업무 절차, 재사용 자산, 발동 조건과 평가 예시'입니다. 필요한 필드만 골라 '스킬 폴더 구조와 사용 경계가 있는 설계 메모' 형태로 정리합니다.
- 왜 연결하는가
- 처음에는 Agent Skills 문서 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
- 마지막 확인
- 검토 대상은 '스킬 폴더 구조와 사용 경계가 있는 설계 메모'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
- 01 · 입력작은 입력 범위업무 절차, 재사용 자산, 발동 조건과 평가 예시업무 조건
- 02 · 현재 자료Agent Skills 문서공식 문서 검토: 입력 범위는 '업무 절차, 재사용 자산, 발동 조건과 평가 예시'입니다. 필요한 필드만 골라 '스킬 폴더 구조와 사용 경계가 있는 설계 메모' 형태로 정리합니다.처리 결과
- 03 · 사람 확인담당자 검토검토 대상은 '스킬 폴더 구조와 사용 경계가 있는 설계 메모'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다.확인 완료
- 04 · 결과검토용 결과스킬 폴더 구조와 사용 경계가 있는 설계 메모
Result
이 흐름으로 남는 값
추천 구성 · Situation 02
스킬 폴더 구조와 사용 경계가 있는 설계 메모을 다음 업무로 이어야 할 때
- 어떤 어려움인가
- '지침·스크립트·참고자료를 어디까지 스킬에 넣고 언제 불러올지 구조를 정하기 어려운 설계 업무' 문제를 한 번 처리해도 결과를 다음 업무로 다시 옮기면 복사·누락·중복이 생깁니다.
- 이렇게 해결합니다
- Agent Skills 문서 단계에서는 공식 문서의 현재 계약과 제한을 먼저 대조합니다. 입력 범위는 '업무 절차, 재사용 자산, 발동 조건과 평가 예시'입니다. 필요한 필드만 골라 '스킬 폴더 구조와 사용 경계가 있는 설계 메모' 형태로 정리합니다. 다음 단계인 Skill: Skill Creator에서는 '평가 기준과 자산 구조가 있는 스킬 초안' 형태로 업무 문맥을 보강합니다.
- 왜 연결하는가
- Agent Skills 문서의 결과에는 원문 식별자와 처리 시각을 붙여 Skill: Skill Creator로 전달합니다. 두 도구가 같은 판단을 반복하지 않도록 처리 역할과 보강 역할을 나눕니다.
- 마지막 확인
- 검토 대상은 '스킬 폴더 구조와 사용 경계가 있는 설계 메모'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 이어서 검토 대상은 '평가 기준과 자산 구조가 있는 스킬 초안'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 두 단계 중 하나라도 근거가 비어 있으면 연결 결과를 미확정으로 남깁니다.
- 01 · 입력업무 입력업무 절차, 재사용 자산, 발동 조건과 평가 예시정리된 입력
- 02 · 현재 자료Agent Skills 문서스킬 폴더 구조와 사용 경계가 있는 설계 메모근거 포함 결과
- 업무 문맥 보강
- 04 · 결과연결 결과원문 근거와 두 단계의 처리 상태가 함께 남은 결과
Result
이 흐름으로 남는 값
추천 구성 · Situation 03
지침·스크립트·참고자료를 어디까지 스킬에 넣고 언제 불러올지 구조를 정하기 어려운 설계 업무를 반복 운영해야 할 때
- 어떤 어려움인가
- '지침·스크립트·참고자료를 어디까지 스킬에 넣고 언제 불러올지 구조를 정하기 어려운 설계 업무' 문제를 정기적으로 처리하려면 성공 경로뿐 아니라 권한 오류, 재실행, 승인 책임까지 정해야 합니다.
- 이렇게 해결합니다
- Agent Skills 문서 단계에서는 공식 문서의 현재 계약과 제한을 먼저 대조합니다. 입력 범위는 '업무 절차, 재사용 자산, 발동 조건과 평가 예시'입니다. 필요한 필드만 골라 '스킬 폴더 구조와 사용 경계가 있는 설계 메모' 형태로 정리합니다. 보강은 Skill: Skill Creator, 전달과 후속 처리는 Claude Code 공식 문서로 분리합니다.
- 왜 연결하는가
- 같은 작업 ID가 Agent Skills 문서 → Skill: Skill Creator → Claude Code 공식 문서 순서로 이어집니다. 마지막 반영 전에는 담당자가 대상과 근거를 확인하고 승인합니다.
- 마지막 확인
- 검토 대상은 '스킬 폴더 구조와 사용 경계가 있는 설계 메모'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 실패한 단계만 다시 실행할 수 있도록 입력 버전·처리 시각·오류·승인자를 기록합니다.
- 업무 담당자01 · 입력반복 실행 입력업무 절차, 재사용 자산, 발동 조건과 평가 예시과 작업 ID작업 요청
- 자동 처리02 · 현재 자료Agent Skills 문서스킬 폴더 구조와 사용 경계가 있는 설계 메모1차 처리
- 외부 연결보강 데이터
- 외부 연결검토 요청
- 사람 확인05 · 사람 확인담당자 승인대상·근거·변경 내용을 확인한 뒤 마지막 반영을 승인승인·보류 기록
- 기록·알림06 · 결과기록·알림작업 ID, 처리 상태, 오류, 승인자를 저장하고 필요한 채널에 결과 전달추적 가능
Result
이 흐름으로 남는 값
연결
Agent Skills는 지침과 메타데이터, 스크립트나 템플릿 같은 선택적 리소스를 하나로 묶어 Claude의 기능을 확장하는 모듈형 단위입니다. 요청과 관련이 있을 때 Claude가 자동으로 해당 스킬을 사용합니다.
주요 내용
- 구조: 모든 스킬은 YAML 프론트매터를 갖춘 SKILL.md 파일을 필요로 하며, name과 description이 필수 항목입니다
- 필드 제약: name은 소문자와 숫자, 하이픈만 허용하고 anthropic·claude 같은 예약어를 쓸 수 없으며, description은 무엇을 하는지와 언제 쓰는지를 모두 담아야 합니다
- 점진적 공개: 메타데이터는 항상 로드되고, 본문 지침은 스킬이 발동될 때, 번들된 참조 파일과 스크립트는 필요한 시점에만 로드됩니다
- 스크립트 실행: 스크립트 코드는 컨텍스트에 들어가지 않고 실행 결과만 반영되므로 번들 자료가 커져도 부담이 적습니다
- 사용 환경: Claude API와 Claude Code, claude.ai에서 사용할 수 있으나 커스텀 스킬은 표면 간에 동기화되지 않습니다
- 보안: 신뢰할 수 있는 출처의 스킬만 사용하고, 외부 출처 스킬은 번들된 모든 파일을 사전에 검토해야 합니다
스킬 작성 규칙이나 컨텍스트 로딩 동작, 환경별 제약을 확인하려 할 때 참고하면 좋습니다.
댓글 0
아직 댓글이 없습니다. 첫 댓글을 남겨보세요.