자동화와 확장
4. 스킬과 플러그인 배포8 / 9

워크북: 반복 업무 하나를 스킬로 승격하기

이름·설명·호출 정책·배포 경로를 한 장으로 정리

실무 워크북 70 XP 12분

실무 워크북

최근 2주간 세 번 이상 반복한 프롬프트를 하나 고르고, 그대로 팀에 배포할 수 있는 스킬 사양으로 옮기세요.

작성 내용 자동 저장

어떤 반복 작업을 스킬로 만들 것인지, 이 스킬이 하지 않을 일은 무엇인지 적으세요. 본문에 남길 절차와 별도 레퍼런스 파일로 뺄 내용을 나누세요.

디렉터리 이름을 정하고, 팀원의 개인 스코프나 플러그인에 같은 이름이 있는지 확인한 결과를 적으세요. 충돌 시 이름 변경과 플러그인 네임스페이스 중 무엇을 쓸지 결정하세요.

description과 when_to_use를 작성하되, 이 스킬이 선택되어야 할 상황 표현을 앞쪽에 배치하세요. 반대로 선택되면 안 되는 상황도 함께 적으세요.

모델 자동 호출을 허용할지 결정하고 근거를 적으세요. allowed-tools에 사전 허용할 최소 집합과, 실제로 막아야 해서 disallowed-tools나 퍼미션 deny로 처리할 도구를 구분하세요.

완성도 점검 기준
  • 이름 정합성호출 이름이 디렉터리에서 온다는 규칙을 반영했고 충돌 확인 결과가 적혀 있다.
  • 선택 가능성설명만 읽고도 언제 이 스킬이 쓰여야 하는지 판정할 수 있다.
  • 권한 정확성사전 허용과 실제 차단을 혼동하지 않고 각각 맞는 수단에 배치했다.

작성한 사양으로 스킬을 만든 뒤 /skills에서 실제 선택된 소스를 확인하고, 샘플 인수로 한 번 호출해 검증하세요.