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

pymatgen 재료 구조 분석

pymatgen으로 결정 구조·조성·상평형·전자구조 데이터를 재현 가능하게 분석·검증·변환하는 스킬입니다.

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

무엇을 해주나

최신 pymatgen API(2026.5.4 / pymatgen-core 2026.7.16 기준)를 사용해 재료 데이터를 다루는 작업을 안전하고 재현 가능하게 안내합니다.

  • 구조/조성 검증: CIF·POSCAR 등을 읽을 때 점유율, 무질서(disorder), 산화수, 최소 원자간 거리, 파서 경고를 빠짐없이 보고합니다.
  • 대칭성 민감도 분석: symprec, angle_tolerance를 격자로 훑어 공간군 배정이 허용오차에 얼마나 민감한지 리포트를 만듭니다.
  • 포맷 변환: 변환 전에 "어떤 정보가 손실되는지" 계획서를 먼저 만들고, 항상 새 경로에 기록해 왕복 검증을 수행합니다.
  • 상평형도(convex hull): 동일한 계산·보정 스킴의 총에너지만 받는 엄격한 JSON 스키마로 오프라인 hull을 계산합니다.
  • VASP/Q-Chem I/O: vasprun.xml에서 밴드구조·DOS를 필요한 부분만 파싱하고, 수렴 여부와 페르미 준위 규약 확인을 강제합니다.
  • Materials Project 조회: 기본은 드라이런(계획)이며, --execute를 붙일 때만 필드·필터·건수가 제한된 단일 쿼리를 실행합니다.
  • 아티팩트 매니페스트: 체크섬·버전·출처를 남겨 결과의 출처 추적을 보장합니다.

이런 분께 추천

  • DFT 계산 결과를 정리하고 논문/보고서용 수치를 검증해야 하는 재료·화학 연구자
  • 결정 구조 데이터베이스를 대량으로 정제하거나 포맷 변환 파이프라인을 만드는 대학원생
  • Materials Project 데이터를 인용·라이선스 조건까지 지켜서 사용해야 하는 연구실
  • 재현성(버전 고정, 프로베넌스 기록)이 중요한 계산 워크플로우 담당자

활용 예시

  1. "이 CIF 파일 신뢰할 수 있어?"composition_structure_validator.py structure.cif로 부분 점유율·병합 경고·비정상적으로 가까운 원자쌍을 한 번에 확인합니다.
  2. "공간군이 논문 값과 다르게 나온다"symmetry_sensitivity_report.py structure.cif --symprec 0.001,0.01,0.1로 Materials Project 관행(0.1 Å)과 pymatgen 기본값(0.01 Å) 차이를 근거와 함께 설명합니다.
  3. "Li-Fe-O 계에서 내 계산 구조가 hull 위에 있나?" — 동일 스킴의 총에너지를 JSON으로 정리해 phase_diagram_generator.py entries.json --analyze Li2O로 hull 위/아래 여부와 분해 반응을 얻습니다.

· · · 설치 가이드 · · ·

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/pymatgen 폴더를 내 ~/.claude/skills/pymatgen/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

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/pymatgen ~/.claude/skills/

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

  1. Claude Code가 설치되어 있고 터미널을 열 수 있는지 확인합니다.
  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/pymatgen ~/.claude/skills/
  5. Python 3.11+와 uv를 준비한 뒤, 스킬 폴더에서 uv venv --python 3.11 .venv-pymatgenuv pip install --python .venv-pymatgen/bin/python "pymatgen==2026.5.4" "pymatgen-core==2026.7.16" "mp-api==0.46.4"를 실행합니다.
  6. (선택) Materials Project를 쓰려면 셸 환경변수로만 export MP_API_KEY=발급받은키를 설정합니다. 키를 커맨드 인자나 파일에 적지 마세요.
  7. Claude Code를 다시 시작하고 "이 CIF 파일 검증해줘"처럼 요청하면 스킬이 자동으로 호출됩니다.
  8. 먼저 python scripts/composition_structure_validator.py --help로 CLI가 잘 동작하는지 확인해 보세요.