Sajja Skill Creator

Sajja Skill Creator

한국 전문직 기여자가 자신의 업무 맥락을 k-sajja-agents 레포지토리에 맞는 SKILL.md로 만들도록 문답을 진행한다. 원본 skill-creator의 흐름을 유지하되, 한국 전문직 업무, 기여자 기반 디렉토리 구조, 공개 전문지식 출처, AI 역할 한계, 전문가 연결, MIT 기여 원칙을 필수 검토 항목으로 추가한다.

About Sajja Skills

스킬은 에이전트가 특정 직업의 업무를 더 잘 수행하도록 돕는 자기완결적 작업 안내서다. 일반 모델이 이미 아는 내용을 길게 설명하는 문서가 아니라, 특정 업무에서 반복적으로 필요한 절차, 판단 순서, 확인 경로, 출력 형식을 제공해야 한다.

전문직 스킬은 특히 다음을 제공해야 한다.

1. 전문직 업무 흐름: 계약서 검토, 진료 전 문진 정리, 선행기술 조사처럼 반복되는 절차
2. 전문지식 확인 경로: 법령, 판례, 고시, 기관자료, 학회 가이드라인, 공개 데이터베이스
3. 역할 경계: AI가 도와줄 수 있는 보조 업무와 전문가가 직접 해야 하는 책임 업무의 구분
4. 재사용 가능한 리소스: 필요한 경우 references/, scripts/, assets/ 같은 보조 파일
5. 전문가 연결: AI의 한계에 도달했을 때 작성자 또는 소속 전문가/업체로 이어지는 안내

Core Principles

Concise is Key

스킬 본문은 에이전트가 실제 작업에 사용할 정보만 담는다. 한국 전문직 제도나 개념을 설명하더라도, 사용자가 이미 알 법한 배경 설명보다 업무 절차와 검토 기준을 우선한다.

• 긴 해설보다 짧은 절차와 예시를 선호한다.
• 외부 자료 원문을 붙여 넣지 말고 확인 경로와 활용 방식을 적는다.
• 동일한 내용은 SKILL.md와 별도 reference 파일에 중복해서 넣지 않는다.

Set Appropriate Degrees of Freedom

업무의 위험도와 반복성에 따라 스킬의 자유도를 정한다.

• 높은 자유도: 상담 전 질문 목록, 검토 관점 정리, 일반 정보 요약처럼 맥락별 변형이 필요한 업무
• 중간 자유도: 계약서 조항 검토 순서, 세무 증빙 분류, 선행기술 검색 쿼리 구성처럼 선호 절차가 있는 업무
• 낮은 자유도: 정해진 양식 변환, 반복 계산, 파일 처리처럼 오류가 치명적이거나 일관성이 중요한 업무

낮은 자유도가 필요한 업무는 가능하면 scripts/나 명확한 체크리스트로 만든다. 다만 이 레포에 넣는 모든 코드와 원문은 MIT 라이선스로 공개 가능해야 한다.

Protect Professional Boundaries

전문직 스킬은 유용해야 하지만 전문가의 책임을 대체하면 안 된다. 각 스킬에는 반드시 다음을 분리해 적는다.

• AI가 수행할 수 있는 일
• AI가 수행하면 안 되는 일
• 전문가에게 연결해야 하는 경우

예를 들어 법률 스킬은 소송대리나 최종 법률의견을 대신하지 않고, 의료 스킬은 진단이나 처방을 하지 않으며, 세무 스킬은 신고대행이나 세액 최종 확정을 하지 않는다.

Protect Validation Integrity

스킬을 만든 뒤에는 실제 사용 예시로 검증한다. 검증할 때는 의도한 답을 알려주지 말고, 사용자가 실제로 할 법한 요청만 넣어 스킬이 질문, 경계 설정, 출력 형식을 제대로 유도하는지 확인한다.

Anatomy of a Sajja Skill

각 직업 스킬은 agents/ 아래의 직업 디렉토리, 그 아래의 기여자 디렉토리 안에 둔다. 기여자 디렉토리는 작성자 이름, 사무소명, 병원명, 업체명 등을 영문 슬러그로 만든다.

agents/
└── lawyer/
    └── hong-gildong/
        ├── PROFILE.md    # 선택
        └── lawyer-contract-review/
            ├── SKILL.md
            ├── references/   # 선택
            ├── scripts/      # 선택
            └── assets/       # 선택

SKILL.md

모든 스킬에는 SKILL.md가 필요하다.

• frontmatter에는 name, description만 둔다.
• name은 스킬 디렉토리명과 일치해야 한다.
• description에는 스킬이 하는 일과 언제 사용해야 하는지를 구체적으로 쓴다.
• 본문은 스킬이 트리거된 뒤 에이전트가 따라야 할 절차와 제약을 담는다.

Bundled Resources

필요한 경우에만 보조 리소스를 추가한다.

• references/: 공개 전문자료 확인 방법, 직역별 체크리스트, 공개 가능한 실무 기준처럼 필요할 때만 읽을 자료
• scripts/: 반복 계산, 파일 변환, 정형 검증처럼 매번 코드로 다시 쓰면 위험한 작업
• assets/: 공개 가능한 템플릿, 예시 파일, 양식, 이미지 등 결과물에 사용되는 자료
• PROFILE.md: 같은 기여자가 만든 여러 스킬에서 공통으로 사용할 작성자 또는 업체 소개, 연락처, 상담 안내

포함하지 말아야 할 것:

• 재배포가 불명확한 유료 자료, 내부 문서, 의뢰인 자료, 환자 정보, 비공개 노하우
• 스킬 실행에 직접 필요 없는 README, 설치 가이드, 변경이력 같은 부가 문서
• 원문 복제가 허용되지 않는 법령 해설서, 판례집, 학회자료, 양식

Progressive Disclosure

스킬은 필요한 정보를 단계적으로 드러내야 한다.

1. 메타데이터: name, description만 항상 노출된다.
2. SKILL.md: 스킬이 호출될 때 본문이 로드된다.
3. 번들 리소스: 에이전트가 필요할 때만 references/, scripts/, assets/를 사용한다.

전문지식이 많다면 SKILL.md에 전부 넣지 말고, 핵심 절차와 어떤 reference를 언제 읽어야 하는지만 둔다. 예를 들어 계약서 검토 스킬은 SKILL.md에 검토 순서를 두고, 개인정보 처리위탁 조항의 상세 확인표는 references/privacy-processing.md로 분리할 수 있다.

Skill Creation Process

다음 순서로 진행한다. 명백히 불필요한 단계만 건너뛴다.

Step 1. Understand the Skill with Concrete Examples

먼저 추상적인 직업 설명이 아니라 실제 사용 예시를 확보한다.

물어볼 것:

• 어떤 직업 패키지에 넣을 스킬인가
• 어떤 기여자 이름 또는 업체명 아래에 둘 것인가
• 사용자가 실제로 어떤 말로 이 스킬을 호출할 것인가
• 입력자료는 무엇인가
• 최종 출력물은 무엇인가
• 성공한 결과와 실패한 결과의 차이는 무엇인가

예시 질문:

이 스킬은 어떤 직업 패키지에 넣을까요? 예: lawyer, doctor, patent-attorney.
작성자 이름, 사무소명, 병원명, 업체명 중 어떤 이름으로 기여자 디렉토리를 만들까요?
사용자가 실제로 할 법한 요청 문장 2~3개를 알려주세요.
스킬이 마지막에 만들어야 하는 결과물은 요약, 체크리스트, 질문 목록, 초안, 리스크 표 중 어떤 형태인가요?

Step 2. Plan Reusable Skill Contents

구체 예시를 보고 SKILL.md만으로 충분한지, 별도 리소스가 필요한지 판단한다.

• 반복되는 절차나 질문 순서만 필요하면 SKILL.md에 둔다.
• 공개 전문자료의 확인 방법이 길면 references/로 분리한다.
• 반복 계산, 파일 변환, 정형 검사가 필요하면 scripts/를 고려한다.
• 공개 가능한 양식이나 템플릿이 필요하면 assets/를 고려한다.

전문직 업무에서는 특히 전문지식 출처 구조를 먼저 설계한다.

직역별 기본 출처 후보:

• 변호사: 국가법령정보센터, 대법원 종합법률정보, 헌법재판소, 개인정보보호위원회, 공정거래위원회, 고용노동부
• 의사: 보건복지부, 질병관리청, 식품의약품안전처, 건강보험심사평가원, 관련 학회 공개 가이드라인
• 변리사: 특허청, KIPRIS, 특허법령, 심사기준 공개자료, WIPO 공개자료
• 세무사: 국세청, 조세법령, 홈택스 안내, 조세심판원 공개 결정례
• 노무사: 고용노동부, 근로복지공단, 중앙노동위원회, 근로기준법령, 산업재해보상보험 관련 공개자료
• 공인중개사: 국토교통부, 부동산거래관리시스템, 등기정보 공개자료, 주택임대차보호법령, 지자체 공개자료
• 약사: 식품의약품안전처, 의약품안전나라, 건강보험심사평가원, DUR 공개 안내, 제품 허가사항

각 출처에 대해 출처명, 링크, 확인일, 활용 범위, 원문 복제 가능 여부를 확인한다.

Step 3. Choose the Repository Path and Name

경로는 이 레포 규칙에 맞춘다.

• 기존 패키지 후보: lawyer, doctor, patent-attorney, tax-accountant, pharmacist, certified-labor-attorney, real-estate-agent, appraiser, customs-broker, judicial-scrivener
• 기여자 슬러그는 작성자 이름, 사무소명, 병원명, 업체명 등을 소문자 영문, 숫자, 하이픈으로 정규화한다.
• 기여자 디렉토리에는 선택적으로 PROFILE.md를 둘 수 있다.
• 스킬 디렉토리 이름은 직업명-스킬이름 형식을 사용한다.
• 이름은 소문자, 숫자, 하이픈만 사용한다.
• 권장 경로는 agents/직업패키지/기여자-slug/직업명-스킬이름/SKILL.md로 제안한다.

예시:

agents/lawyer/hong-gildong/lawyer-contract-review/SKILL.md
agents/doctor/seoul-pain-clinic/doctor-pre-visit-summary/SKILL.md
agents/patent-attorney/ip-seoul/patent-attorney-prior-art-search/SKILL.md

Step 4. Draft or Update the Skill

개별 직업 스킬 초안은 아래 구조를 기본값으로 작성한다. 업무 특성상 일부 섹션은 줄일 수 있지만, 전문지식 확인 경로, AI 역할 경계, 출처 및 라이선스는 유지한다.

---
name: 직업명-스킬이름
description: 이 스킬이 수행하는 업무와 사용해야 하는 상황을 한 문단으로 설명합니다.
---

# 스킬 제목

## 사용 목적

## 사용자가 제공해야 할 정보

## 전문지식 확인 경로

## AI가 수행할 수 있는 일

## AI가 수행하면 안 되는 일

## 전문가에게 연결해야 하는 경우

## 작업 절차

## 출력 형식

## 출처 및 라이선스

## 전문가 프로필 및 연락처

역할 경계 예시:

• 법률: 소송대리, 최종 법률의견, 개별 사건 수임 판단, 승소 가능성 단정, 변론 전략 확정 금지
• 의료: 진단, 처방, 치료 결정, 응급 여부 단정, 검사 결과의 최종 의학적 판정 금지
• 세무: 신고대행, 세액 최종 확정, 세무조사 대응 전략 확정, 가산세 책임 판단 금지
• 특허: 출원 가능성 최종 판단, 청구항 확정, 거절이유 대응 전략 확정, 대리 행위 금지
• 부동산: 권리관계 최종 보증, 계약 체결 대리, 투자수익 보장, 중개 책임 대체 금지

전문가 연결 섹션에는 선택적으로 다음을 포함한다.

• 작성자 이름 또는 업체명
• 전문 분야
• 지역 또는 서비스 가능 범위
• 웹사이트, 이메일, 전화번호, 예약 링크 등 연락 방법
• 광고, 소개, 일반 정보 제공, 전문 상담의 경계를 설명하는 문구
• 긴급 상황이나 법정 기한처럼 즉시 전문가 상담이 필요한 조건

같은 기여자의 공통 소개가 여러 스킬에 반복될 경우, 개별 스킬에는 간단한 연결 문구를 두고 상세 정보는 기여자 디렉토리의 PROFILE.md에 둔다.

Step 5. Validate the Skill

초안이 완성되면 다음을 점검한다.

• 경로가 agents/직업명/기여자-slug/직업명-스킬이름/SKILL.md 형식인가
• 기여자 슬러그가 소문자 영문, 숫자, 하이픈으로 정규화되어 있는가
• 스킬 디렉토리명이 직업명-스킬이름 형식인가
• frontmatter에 name, description만 있는가
• description이 트리거 상황을 충분히 설명하는가
• SKILL.md가 실제 작업 절차를 제공하는가
• 공개 전문자료의 출처명, 링크, 확인일, 활용 범위가 있는가
• 외부자료 원문을 과도하게 복사하지 않았는가
• 레포에 작성한 원문 기여가 MIT 라이선스로 공개 가능한가
• AI 가능 업무와 불가능 업무가 분리되어 있는가
• 전문가 연결 조건과 연락처 섹션이 있는가
• 한국어 사용자에게 자연스러운 입력 예시와 출력 형식이 있는가

가능하면 원본 skill-creator의 검증 방식처럼 realistic prompt로 테스트한다.

예시:

변호사용 계약서 검토 스킬을 만들고 싶어.
의사용 진료 전 문진 정리 스킬을 만들고 싶어.
변리사용 선행기술 조사 스킬을 만들고 싶어.

Step 6. Iterate

사용자가 실제로 스킬을 써본 뒤 막히는 지점을 반영한다.

• 질문이 너무 많으면 첫 질문 수를 줄인다.
• 답변이 추상적이면 입력 예시와 출력 형식을 구체화한다.
• 외부자료 확인이 불안정하면 출처 구조를 보강한다.
• 전문 상담이 필요한 상황을 놓치면 역할 경계와 전문가 연결 조건을 강화한다.

PR Description and Admin Verification

스킬 초안과 함께 PR 설명에 들어갈 관리자 검수 정보를 정리한다. 공개 PR에 민감정보를 올리지 않도록 주의시킨다.

PR 설명에 포함할 항목:

• 직업 패키지, 기여자 슬러그, 추가/수정한 스킬, 권장 경로
• 이름 또는 업체명, 직역 또는 전문 분야, 소속 또는 운영 주체
• 공개 프로필, 홈페이지, 예약 페이지, 관리자 확인용 연락 가능 경로
• 자격 또는 경력 확인 방법
• PROFILE.md 추가 여부
• 스킬이 해결하는 실제 업무, 입력, 출력 형식
• AI가 수행할 수 있는 일, 수행하면 안 되는 일, 전문가에게 연결해야 하는 경우
• 참고한 공개 출처, 링크, 확인일, 활용 범위, 라이선스 또는 이용 조건

공개 PR에 올리면 안 되는 항목:

• 주민등록번호, 자격증 사본, 민감한 자격번호
• 의뢰인 정보, 환자 정보, 내부 문서
• 재배포가 불명확한 유료 자료나 비공개 양식

Copyright and MIT Contribution Rules

이 레포에 작성되는 원문 기여는 MIT 라이선스로 공개된다. 스킬 생성 과정에서 반드시 이 점을 확인한다.

• 기여자가 직접 작성한 문장, 절차, 예시는 MIT 라이선스로 공개 가능해야 한다.
• 외부 전문자료는 원문 복사 대신 출처명, 링크, 확인일, 활용 범위를 기록한다.
• 원문 복제가 허용되는 공공자료라도 필요한 범위만 요약하고, 출처를 남긴다.
• 유료 자료, 내부 문서, 의뢰인 자료, 환자 정보, 비공개 양식, 재배포가 불명확한 자료는 포함하지 않는다.

Final Response Format

문답이 충분히 끝나면 다음 형식으로 답한다.

권장 경로:
agents/직업패키지/기여자-slug/직업명-스킬이름/SKILL.md

기여자 프로필 계획:
- PROFILE.md 사용 / 개별 SKILL.md에만 기재 / 프로필 생략

재사용 리소스 계획:
- SKILL.md만 사용 / references 필요 / scripts 필요 / assets 필요

기여 전 확인:
- 이 스킬의 원문 기여는 MIT 라이선스로 공개됩니다.
- 외부자료는 원문 복사가 아니라 출처와 접근 경로만 기록했습니다.
- AI가 할 수 있는 일과 전문가에게 넘겨야 하는 일을 구분했습니다.

PR 요약:
- ...

PR 설명에 포함할 관리자 검수 정보:
- 이름 또는 업체명:
- 공개 프로필/홈페이지:
- 관리자 확인용 연락 가능 경로:
- 자격 또는 경력 확인 방법:
- 민감정보는 공개 PR에 포함하지 않았습니다.

SKILL.md 초안:
...