클로드스킬마트스킬 둘러보기스킬이 뭐예요?
목록으로

유전체 좌표 변환기

BED·GFF·VCF 등 포맷 간 좌표 변환과 변이 정규화, 어셈블리 불일치 진단을 한 번에 처리하는 유전체 분석 스킬.

데이터·분석고급33,0303,248AI 점수 9/10마지막 업데이트: 2026. 8. 9.

무엇을 해주나

유전체 데이터에서 가장 조용하고 치명적인 버그인 "좌표 오류"를 잡아줍니다.

  • 포맷 간 좌표 변환: BED / bedGraph / PSL / genePred(0-based, half-open)와 GFF3 / GTF / VCF / WIG / Picard interval_list(1-based, inclusive) 사이를 표 기반으로 정확히 변환합니다. convert_coords.py가 UCSC 리전 문자열(chr7:5,530,601-5,530,625)도 처리합니다.
  • 변이 정규화: normalize_variant.py로 인델을 파시모니 트리밍 후 좌측 정렬(left-align)하고, 두 변이 표기가 같은 변화인지 비교합니다. 다중 대립유전자 레코드는 --split으로 먼저 분리합니다.
  • 어셈블리 진단: check_contigs.py.fai, .chrom.sizes, VCF/SAM 헤더를 읽어 GRCh37 / hg19 / GRCh38 / T2T를 식별하고 chr 접두사 불일치, 길이 충돌, 컨티그 누락을 보고합니다.
  • 파일 감사: audit_intervals.py가 0-based 데이터가 1-based 파일에 들어간 흔적, 컨티그 끝 초과, 혼합 명명 규칙 등을 찾아내며 종료 코드 1로 CI 게이트 역할도 합니다.
  • 전사체/CDS/단백질 좌표: c.742와 게놈 좌표의 관계, HGVS 3' 시프트 규칙, GFF phase의 의미 등 자주 틀리는 규칙을 정리해 줍니다.

이런 분께 추천

  • VCF, BED, GTF를 매일 다루는 생물정보학 연구자 및 파이프라인 엔지니어
  • ClinVar/gnomAD 등 외부 DB와 변이를 조인하는데 매칭률이 이상하게 낮은 경험을 해본 분
  • GRCh37/GRCh38 혼용 파이프라인을 정리해야 하는 분
  • 좌표 규칙을 매번 검색해서 확인하는 대학원생·신입 분석가

활용 예시

  1. 오프바이원 추적: "peaks.bed와 gencode.gtf를 교집합했더니 결과가 1bp씩 밀린 것 같아" → 스킬이 두 포맷의 규칙을 확인하고 audit_intervals.py로 BED에 1-based 데이터가 섞였는지 검사합니다.
  2. 변이 매칭 실패 해결: "chr1:7:CAC:C가 ClinVar에서 안 잡혀요" → 참조 FASTA로 좌측 정렬해 chr1:2:GCA:G로 정규화하고 동일 변이임을 확인해 줍니다.
  3. 어셈블리 불일치 진단: 조인 결과가 비정상이면 check_contigs.py --identify로 한쪽이 GRCh37인지, mtDNA 길이(16,569 vs 16,571)로 hg19인지까지 판별합니다.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 K-Dense-AI/scientific-agent-skills 의 skills/genomic-coordinates 폴더를 내 ~/.claude/skills/genomic-coordinates/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/scientific-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/scientific-agent-skills/skills/genomic-coordinates ~/.claude/skills/

제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 Python 버전을 확인합니다: python3 --version (3.11 이상이어야 합니다).
  2. 저장소를 내려받습니다: git clone https://github.com/K-Dense-AI/scientific-agent-skills.git
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  4. 이 스킬만 복사합니다: cp -r scientific-agent-skills/skills/genomic-coordinates ~/.claude/skills/
  5. Claude Code를 재시작한 뒤 "BED를 GTF 좌표로 바꿔줘" 또는 "이 VCF 정규화해줘" 같이 요청하면 스킬이 자동으로 실행됩니다.
  6. 변이 정규화 기능을 쓰려면 참조 FASTA 파일(가능하면 samtools faidx로 만든 .fai 인덱스 포함)을 미리 준비하세요.
  7. 스크립트를 직접 쓰고 싶다면 cd ~/.claude/skills/genomic-coordinates/scripts && python3 convert_coords.py --list로 변환 표를 확인할 수 있습니다.