Step 4. 커스터마이즈

스킬은 그냥 텍스트 파일입니다. 누구나 수정하고 새로 만들 수 있습니다.

쉬운 방법 — Claude에게 시키세요

파일을 직접 열 필요 없습니다. 바꾸고 싶은 걸 Claude에게 말하세요:

기존 스킬 수정

"check-reporting 스킬이 결과를 항상 한국어로 출력하도록 바꿔줘"

새 스킬 만들기

"radiology-report라는 새 스킬을 만들어줘. ACR 가이드라인에 맞는 구조화 판독문을 생성하는 스킬이야"

최신 버전으로 업데이트

"npx medsci-skills@latest install 을 실행해서 MedSci Skills를 최신 버전으로 업데이트하고, Claude Code를 재시작하라고 안내해줘"

Claude가 SKILL.md 파일을 수정하고, 폴더를 만들고, 모든 걸 알아서 처리합니다. 아래는 내부에서 어떤 일이 일어나는지 참고용으로 정리한 것입니다.

참고: 직접 편집하기

스킬의 구조

모든 스킬은 하나의 폴더 안에 SKILL.md파일로 구성됩니다. 이 파일이 Claude에게 "이 상황에서 이렇게 행동해라"는 지침서입니다.

SKILL.md 기본 구조

---
name: my-custom-skill
description: 우리 병원 양식의 보고서를 요청할 때 사용. 아래 양식에 소견을 채워 넣습니다.
metadata:
  triggers: "보고서, report"
---

# 규칙

1. 사용자가 보고서를 요청하면 다음 양식을 따릅니다.
2. 환자 정보는 익명화합니다.
3. 결론은 반드시 근거를 포함합니다.

# 양식

## 제목
## 소견
## 결론
## 참고문헌

name — 스킬 이름 (폴더 이름과 같게)

description— 언제 쓰는 스킬인지, 그리고 무엇을 하는지. Claude는 이 문장을 보고 스킬을 불러올지 정하므로 "…할 때 사용"으로 시작해 짧게 씁니다 (MedSci Skills의 description은 모두 300자 이내)

metadata.triggers — 선택 항목인 키워드 목록으로, MedSci Skills의 자체 규칙입니다. Claude는 이 목록이 아니라 description을 보고 판단합니다

본문 — Claude에게 주는 구체적인 지침 (자연어)

기존 스킬 수정하기

1. ~/.claude/skills/ 안의 원하는 스킬 폴더를 엽니다.

2. SKILL.md를 일반 텍스트 편집기(메모장, TextEdit)로 엽니다.

3. 원하는 부분을 수정합니다. 예를 들어:

기본 언어를 한국어로 변경
특정 저널 양식에 맞게 포맷 수정
병원 내부 규정에 맞는 규칙 추가

4. 저장 후 Claude Code Desktop을 재시작합니다.

나만의 스킬 만들기

1. ~/.claude/skills/에 새 폴더를 만듭니다.

~/.claude/skills/my-report-template/

2. 그 안에 SKILL.md 파일을 만들고 위 양식대로 작성합니다.

3. Claude Code Desktop을 재시작하면 새 스킬이 자동으로 로드됩니다.

팁

기존 스킬을 복사한 뒤 수정하면 더 빠릅니다. 예를 들어 check-reporting 폴더를 복사해서 이름을 바꾸고, 체크리스트만 자기 병원 기준으로 수정할 수 있습니다.

스킬 업데이트

MedSci Skills는 지속적으로 개선됩니다. 최신 버전으로 업데이트하려면:

1. 터미널에서 npx medsci-skills@latest install을 실행합니다. classroom 설치 파일로 설치했다면 대신 바탕화면의 "Update MedSci Skills" 아이콘을 더블클릭하세요.

2. Claude Code를 재시작합니다.

설치 프로그램은 직접 수정한 스킬을 교체하기 전에 ~/.medsci-skills/backups/에 복사해 둡니다. 새 ZIP으로 직접 덮어쓰는 경우, 복사는 파일을 추가만 하고 지우지는 않습니다. 수정한 스킬을 먼저 백업하고, v6에서 이름이 바뀐 스킬은 MIGRATION-v6.md를 따르세요.

Orchestrate의 역할

orchestrate 스킬은 다른 모든 스킬의 교통정리 역할을 합니다. 사용자가 무엇을 원하는지 파악하고 적절한 스킬로 자동 라우팅합니다.

나만의 스킬을 추가해도 orchestrate가 자동으로 인식합니다. 새 스킬의 description에 언제 쓰는 스킬인지만 분명히 적으면 됩니다.

← 이전: 상황별 스킬 안내 FAQ →