OpenClaw-Medical-Skills

무엇인가

OpenClaw-Medical-Skills는 OpenClaw·NanoClaw 계열 Claude 기반 에이전트에 생의학·임상 연구 절차를 주입하는 스킬 묶음이다. 각 스킬은 독립된 SKILL.md 파일 하나로 존재하며, 그 파일이 로드되면 에이전트는 해당 영역의 용어·워크플로·출력 형식을 규칙으로 삼는다. 규율 대상은 크게 네 갈래다. 임상 문서·보고서 작성, 유전체·변이 해석, 신약 탐색과 약물 안전성, 바이오인포매틱스 파이프라인 실행이다. 이 스킬들은 지식 요약문이 아니라 실행 절차에 가깝다. 어떤 데이터베이스를 어떤 순서로 조회하고, 결과를 어떤 필드로 정리해 내놓을지까지 파일 안에 적혀 있다. 그래서 에이전트는 일반 지식으로 답을 구성하는 대신 스킬에 정의된 도구 호출 경로를 따라간다. 의료기기 규제 문서나 임상 AI 산출물을 다루는 항목도 같은 구조를 공유한다.

어떻게 동작하나

이 규칙이 없을 때 나타나는 실패는 대부분 근거 없는 확신이다. 범용 에이전트는 유전자 변이의 임상적 의미를 물으면 기억에 의존해 그럴듯한 해석을 만들어 내고, 실제 변이 데이터베이스 조회 없이 병원성 등급을 단정한다. 약물 상호작용 질문에는 상호작용이 없다고 잘라 말하거나, 반대로 존재하지 않는 상호작용을 목록처럼 나열한다. 임상 보고서를 요청하면 서술형 문단만 늘어놓고 필수 항목인 환자 정보, 검사 수치, 해석, 권고를 빠뜨린다. 파이프라인 작업에서는 참조 게놈 버전이나 정규화 단계를 임의로 정하고 재현 불가능한 명령을 제시한다. 이런 오류는 문장이 매끄러울수록 발견이 늦다. 스킬은 각 영역에서 무엇을 조회해야 답으로 인정되는지를 미리 고정해, 에이전트가 기억이 아니라 도구 호출 결과를 근거로 문장을 만들도록 강제한다.

무엇과 다른가

설계 원리는 도메인별 하드 제약이다. 각 SKILL.md는 자유 서술 대신 단계 목록과 필수 필드로 쓰인다. 변이 해석 스킬은 데이터베이스 조회, 인구 빈도 확인, 병원성 등급 근거 제시를 순서로 요구하고, 등급을 확정할 수 없으면 불확실로 남기도록 지시한다. 약물 안전성 스킬은 상호작용·부작용·금기 항목을 분리해 각각 출처를 붙이게 한다. 임상 보고서 스킬은 섹션 템플릿을 고정해 누락을 막는다. 예외 조항도 같은 원리로 존재한다. 데이터베이스 응답이 없거나 접근 권한이 없을 때는 추정으로 메우지 말고 조회 실패를 그대로 보고하도록 적는다. 문구가 명령형인 이유도 같다. 고려할 수 있다 같은 표현은 에이전트가 건너뛸 여지를 남기므로, 조회·검증·출력 단계는 단정형으로 쓰인다.

어떻게 쓰나

발동은 파일 로드로 일어난다. OpenClaw는 워크스페이스의 skills 디렉터리와 전역 ~/.openclaw/skills/ 두 곳에서 스킬을 읽고, 다음 세션 시작 시 자동으로 인식한다. 재시작은 필요하지 않다. NanoClaw는 컨테이너의 container/skills/ 경로에서 시작 시점에 읽으므로, 파일을 넣은 뒤 컨테이너를 다시 빌드해야 반영된다. 개별 스킬은 SKILL.md 한 파일이 단위이지만, 저장소에는 대용량 데이터 파일을 동반하는 항목도 있어 sparse-checkout으로 skills 디렉터리만 받는 방식이 권장된다. 전역 설정 파일 ~/.openclaw/openclaw.json의 plugins.local 배열에 저장소 경로를 넣으면 복사 없이 전체 묶음을 마운트할 수 있다. 로드 후에는 에이전트에게 보유 스킬 목록을 물어 어떤 항목이 실제로 인식됐는지 확인하는 것이 첫 점검 절차다.

전제와 한계

내부 구성은 상위 섹션과 하위 스킬군으로 나뉜다. General & Core의 General Tools를 시작으로, Medical & Clinical에는 Medical Tools, Drug Safety & Chemical Biology, Medical Imaging & Pathology, Healthcare ML & Clinical AI, Mental Health & Crisis Intervention, Medical Device & Regulatory, Medical Device Software(meddev-agent-skills)가 묶인다. Scientific Databases는 Genomics & Variants, Cancer Genomics Databases, Structural Biology & Drug Discovery로 갈라지고, gptomics bio-* 계열은 Sequencing & Read QC, Differential Expression & Transcriptomics, Single-Cell & Spatial Omics, Epigenomics & Chromatin, Metagenomics & Microbiome, Multi-Omics Integration, Proteomics & Metabolomics, Epidemiological & Causal Genomics를 포함한다. ClawBio Pipelines는 파이프라인 오케스트레이션과 유전체·약물유전체, 구조생물학·문헌 항목을 두고, BioOS Extended Suite는 Oncology & Precision Medicine Agents, Hematology & Blood Disorders, Immunology & Cell Therapy, Drug Discovery & Design, Clinical AI & Healthcare를 담는다. 각 SKILL.md는 도메인 지식, 워크플로 단계, 도구 연결, 출력 형식을 한 파일에 함께 둔다.

프롬프트를 대화창에 직접 쓰는 방식과 구조가 다르다. 직접 쓴 지시는 세션이 끝나면 사라지고 버전 관리되지 않으며, 어떤 도구를 어떤 순서로 부를지 고정하지 못한다. 이 저장소의 스킬은 SKILL.md 파일로 저장소에 남고, 도구 호출 경로와 출력 필드를 파일 안에 못박는다. 프로젝트 규칙 파일인 CLAUDE.md·AGENTS.md와도 층이 다르다. 그쪽은 프로젝트 하나에 적용되는 일반 규칙 한 벌이고, 이쪽은 도메인별로 쪼갠 다수의 자립 모듈이라 필요한 것만 골라 넣을 수 있다. 플러그인 레지스트리와의 차이는 배포 단위다. openclaw plugins install은 스킬 하나를 설치하지만, 이 저장소는 여러 출처에서 모은 묶음을 통째로 받아 쓰는 소스에 해당한다. 도구 서버를 제공하는 것이 아니라 도구를 부르는 절차를 규정한다는 점도 구분점이다.

설치 경로는 두 갈래다. OpenClaw는 워크스페이스의 skills 디렉터리와 전역 ~/.openclaw/skills/에 스킬을 두고, 저장소는 git clone --depth=1 --no-checkout 뒤 git sparse-checkout set skills로 skills 디렉터리만 받은 다음 cp -r skills/* ~/.openclaw/skills/로 복사한다. 복사를 피하려면 ~/.openclaw/openclaw.json의 plugins.local 배열에 저장소 경로를 넣는다. 일부만 필요하면 clinical-reports, tooluniverse-drug-research, clinicaltrials-database 같은 항목을 골라 개별 복사한다. NanoClaw는 container/skills/에 넣고 ./container/build.sh로 컨테이너를 다시 빌드한다. 설치 후에는 에이전트에게 "What medical and clinical skills do you have available?"를 물어 인식된 스킬과 각 역량이 나열되는지 확인한다.

전제 조건이 분명하다. OpenClaw가 설치·실행 중이거나 대안으로 NanoClaw가 있어야 하고, 복제를 위해 Git이 필요하다. 로드 경로가 OpenClaw와 NanoClaw 각각의 디렉터리 규약에 묶여 있으므로, 문서에 적힌 방식으로는 Codex·Cursor 같은 다른 에이전트에 그대로 얹히지 않는다. 대용량 데이터 파일을 동반한 스킬이 있어 전체 저장소를 받으려면 Git LFS를 먼저 설치해야 하고, 그렇지 않으면 sparse-checkout으로 skills 디렉터리만 받는 편이 안전하다. OpenClaw는 다음 세션에서 자동 인식되어 재시작이 필요 없지만, NanoClaw는 컨테이너 재빌드가 반영 조건이다. 스킬은 절차를 규정할 뿐 데이터베이스 접근 권한이나 API 자격 증명을 대신 마련하지 않는다. 조회가 실패하면 추정으로 메우지 않고 실패를 보고하도록 되어 있으므로, 외부 접근이 없는 환경에서는 산출물의 근거가 얇아진다.

선택 기준은 작업의 근거 요구 수준이다. 변이 병원성 등급, 약물 상호작용, 임상시험 정보처럼 데이터베이스 조회 결과가 답의 근거가 되어야 하는 작업이면 해당 스킬을 설치한다. 임상 보고서나 의료기기 규제 문서처럼 섹션 누락이 곧 결함인 산출물이면 템플릿을 고정한 스킬이 유리하다. 재현 가능한 파이프라인 명령이 필요하면 bio-* 계열이나 ClawBio 항목을 쓴다. 반대로 저장소 구조 파악이나 리팩터링처럼 프로젝트 규칙만으로 충분한 작업에는 CLAUDE.md 한 벌이 가볍다. 역량 하나만 필요하면 전체 묶음을 복사하지 말고 openclaw plugins install로 단일 스킬을 받는다. 도구 호출 없이 용어 설명만 필요한 경우에는 스킬 파일이 오히려 부담이므로 일반 프롬프트로 처리한다.