스킬 참조 파일 정리법: 예시와 기준을 따로 두세요

5분 읽기유튜브 「메이커 에반」을 만드는 스킬샵 운영자

스킬에 용어표와 예시를 계속 붙이다 보면 정작 작업 순서를 찾기 어려워져요. SKILL.md에는 사용할 때 따라야 할 순서를 남기고, 긴 기준표와 결과 예시는 별도 파일로 나눠 보세요. 파일을 나눈 뒤에는 어디에 있는지만 적지 말고 어느 단계에서 읽어야 하는지도 알려 줘야 해요.

작업 지침과 참고 자료를 한 폴더에 모아 둔 일러스트
스킬에는 작업 방법과 필요한 참고 자료를 함께 담을 수 있어요. AI로 제작한 설명용 일러스트예요.

어떤 내용을 먼저 나누나요?

여러 문단에 걸친 용어표, 긴 예시, 결과 양식처럼 작업 순서와 성격이 다른 자료부터 나눠요. 두세 줄짜리 규칙까지 각각 파일로 만들면 오히려 찾아다닐 곳이 늘어나요.

예를 들어 고객 공지 교정 스킬에는 교정 순서를 남기고, 서비스 용어 목록은 references/terms.md, 결과 예시는 examples/notice.md로 둘 수 있어요. 폴더 이름은 정리 방식의 예시예요.

폴더는 어떻게 구성하면 되나요?

먼저 지침 하나, 참고 자료 하나로 시작해 보세요. 실제로 여러 번 찾아 쓰는 자료가 생기면 examples나 templates 폴더를 추가해도 돼요. 처음부터 빈 폴더를 모두 만들 필요는 없어요.

  • notice-edit
  • SKILL.md작업 순서와 읽을 자료 안내
  • references
  • terms.md서비스 용어 기준
  • examples
  • notice.md교정 전후 예시
파일의 역할이 이름에 드러나도록 정리해요.

본문에서는 참조 파일을 어떻게 안내하나요?

‘참고 자료 있음’만 적으면 언제 읽어야 할지 알기 어려워요. 작업 단계와 연결해서 안내해 주세요. 상대 경로는 스킬 폴더 기준으로 적으면 다른 컴퓨터로 옮길 때도 관리하기 좋아요.

본문 예시: ‘교정을 시작하기 전에 references/terms.md를 읽고 서비스 이름과 기능 용어를 확인해요. 결과 형식이 필요한 경우 examples/notice.md를 참고해요. 예시의 날짜와 이름은 새 결과에 복사하지 않아요.’

예시에는 무엇을 넣어야 하나요?

완성문만 두기보다 입력과 결과를 함께 두면 무엇을 바꿨는지 알 수 있어요. 번역투는 고치되 날짜는 보존한다는 기준이라면 날짜가 들어간 짧은 예시를 쓰면 돼요.

예시라는 표시도 붙여 주세요. 가상의 회사명이나 수치가 실제 작업의 사실로 섞이지 않도록 ‘형식 참고용, 내용 재사용 금지’처럼 역할을 밝혀 두면 좋아요.

옮기거나 공유하기 전에 무엇을 확인하나요?

SKILL.md만 복사하면 참조 파일이 빠질 수 있어요. 스킬 폴더 전체를 확인하고, 본문에서 가리키는 파일이 실제로 있는지 열어 보세요. 내 컴퓨터의 사용자 이름이 들어간 경로나 접근할 수 없는 사내 링크도 살펴봐요.

파일을 나눈 뒤에는 새 대화에서 작업 하나를 실행해 보세요. 자료가 없으면 어떤 파일이 필요한지 알려 주는지, 예시의 값을 새 결과에 그대로 복사하지 않는지도 확인해요.

  • 본문의 상대 경로가 실제 파일과 일치해요.
  • 필요한 참조 파일이 모두 포함되어 있어요.
  • 예시와 실제 업무 자료가 구분되어 있어요.
  • 공유할 수 없는 정보가 들어 있지 않아요.

자주 묻는 질문

Q. references라는 폴더 이름이 필수인가요? A. 여기서는 참고 자료를 구분하기 위해 사용한 이름이에요. 도구나 스킬 형식의 요구 사항이 있다면 해당 안내를 우선 확인해 주세요.

Q. 파일을 나누기만 하면 덜 읽게 되나요? A. 읽는 시점과 조건이 함께 정리되어야 해요. 매 작업마다 모든 참조 파일을 읽도록 쓰면 나눈 효과가 줄어들어요.