유전체 좌표 정리사 (genomic-coordinates)
BED·GFF·VCF·SAM 등 서로 다른 좌표 규칙과 게놈 어셈블리 사이에서 발생하는 조용한 off-by-one 오류를 잡아주는 스킬입니다.
데이터·분석중급★ 33,030⑂ 3,248AI 점수 9/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
- 좌표계 변환: 0-based half-open(BED, bedGraph, PSL, genePred)과 1-based inclusive(GFF/GTF, VCF, SAM, WIG, Picard interval_list) 사이를 표에 근거해 변환합니다.
convert_coords.py로 포맷·리전 문자열(chr7:5,530,601-5,530,625)까지 처리합니다. - 변이 표현 정규화:
normalize_variant.py로 인델을 trim + 좌측 정렬하고, 두 변이 레코드가 같은 변화를 뜻하는지 비교하며, 다중 대립유전자 레코드를 먼저 분리합니다. REF는 참조 FASTA와 대조 검증합니다. - 어셈블리/컨티그 진단:
check_contigs.py가 .fai/.chrom.sizes/VCF·SAM 헤더를 읽어 GRCh37 vs hg19 vs GRCh38 vs T2T, chr 접두사 불일치, 길이 충돌, 컨티그 끝을 넘는 좌표를 찾아냅니다. - 파일 감사:
audit_intervals.py가 BED/GTF/VCF에서start_below_one,many_zero_length,past_contig_end,not_parsimonious같은 실수 흔적을 찾고, 치명적 문제 시 exit code 1을 반환해 CI 게이트로 쓸 수 있습니다. - 전사체/CDS/단백질 좌표: HGVS
c.번호 규칙, phase, 마이너스 가닥 처리 등 자주 틀리는 지점을 정리하고 VEP·bcftools csq 같은 적합한 도구 사용을 안내합니다.
이런 분께 추천
- 유전체·엑솜 분석 파이프라인을 만드는 생물정보학 연구자와 엔지니어
- ClinVar·GnomAD 등 외부 DB와 변이를 조인하거나 중복 제거하는 임상 유전체 담당자
- 여러 도구(bedtools, samtools, bcftools, UCSC, Ensembl)의 출력을 합치다가 좌표가 한 칸 밀린 경험이 있는 사람
활용 예시
- "이 peaks.bed를 GTF 좌표로 바꿔줘" → 규칙표에 따라 start만 +1 하고, 길이 0 구간은 변환 불가로 보고.
- "우리 VCF의 인델이 ClinVar와 매칭되지 않아" →
--split후 좌측 정렬 정규화, 두 표현이 동일 변이인지--compare로 확인. - "annotation.gtf와 variants.vcf를 조인했는데 결과가 이상해" →
check_contigs.py로 GRCh37/hg19/GRCh38 판별 및 chr 접두사 불일치 진단.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/K-Dense-AI/scientific-agent-skills/HEAD/skills/genomic-coordinates/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 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 && mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/genomic-coordinates ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 복제합니다:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - 스킬 디렉터리를 준비합니다:
mkdir -p ~/.claude/skills - 이 스킬만 복사합니다:
cp -r scientific-agent-skills/skills/genomic-coordinates ~/.claude/skills/ - Python 버전을 확인합니다:
python3 --version(3.11 이상 필요, 추가 패키지는 없음). - 변이 정규화를 쓰려면 참조 FASTA와 가능하면
.fai인덱스를 준비합니다(samtools faidx ref.fa). - Claude Code를 재시작한 뒤 "이 BED를 VCF 좌표로 변환해줘" 또는 "이 인델을 정규화해줘"처럼 요청하면 스킬이 자동 발동합니다.
GitHub에서 원본 보기 ↗라이선스: MIT