Opentrons 프로토콜 통합
Opentrons Flex·OT-2 실험 로봇용 Python Protocol API v2 프로토콜을 작성·검증·마이그레이션·시뮬레이션하도록 돕는 스킬입니다.
자동화·워크플로고급★ 33,030⑂ 3,248AI 점수 8/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
Opentrons 액체 취급 로봇(Flex, OT-2)에서 실행할 Python Protocol API v2 프로토콜을 처음부터 작성하거나, 기존 코드를 최신 API 레벨로 마이그레이션하고 문제를 진단해 줍니다.
- 로봇 종류별 올바른
requirements/metadata구성과 API 레벨 선택(2.15~2.29 게이트 정리) - 덱 슬롯, 랩웨어 로드명, 어댑터, 휴지통·폐기 슈트, 모듈(서모사이클러, 플레이트 리더, Stacker 등) 설정
- 피펫·팁 선택,
transfer/distribute/consolidate및 liquid class 기반 명령 선택 - 런타임 파라미터(CSV 포함), 시약량·팁 수 예산 계산
opentrons_simulate로컬 시뮬레이션 → Opentrons App 분석 → 드라이런까지 단계별 검증 절차- 자주 발생하는 실패 패턴(구버전 피펫 이름, apiLevel 중복 선언, OT-2에 2.29 사용 등) 점검
또한 기본 전송, 연속 희석, PCR 세팅, 런타임 파라미터, 흡광도 리더 템플릿 스크립트와 6종 레퍼런스 문서를 함께 제공합니다.
이런 분께 추천
- Opentrons Flex 또는 OT-2를 운용하는 실험실 연구자·자동화 엔지니어
- 손으로 작성한 프로토콜을 최신 로봇 소프트웨어에 맞춰 업데이트해야 하는 분
- 팀 내 프로토콜 코드 리뷰와 안전 점검 체크리스트가 필요한 분
활용 예시
- "Flex 1채널 1000µL로 12채널 리저버에서 96웰 플레이트에 버퍼 100µL씩 분주하는 프로토콜을 API 2.29로 작성해줘" → 올바른 랩웨어 로드명과 휴지통 설정이 포함된 코드 생성.
- "이 2.13 OT-2 프로토콜을 2.28로 마이그레이션하고 시뮬레이션 명령까지 알려줘" → 마이그레이션 레퍼런스 기반 수정 +
uv run --with "opentrons==9.0.0" opentrons_simulate실행 안내. - "플레이트 리더로 읽으려니 오류가 난다" →
initialize()후read()호출 순서 등 흔한 실패 모드 진단.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 K-Dense-AI/scientific-agent-skills 의 skills/opentrons-integration 폴더를 내 ~/.claude/skills/opentrons-integration/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git && mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/opentrons-integration ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- Python 3.10 이상과 uv를 설치합니다. (로컬 시뮬레이션에 필요)
- 터미널에서 저장소를 클론합니다:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r scientific-agent-skills/skills/opentrons-integration ~/.claude/skills/ - Claude Code를 다시 시작하고 "Opentrons Flex 프로토콜을 만들어줘"처럼 요청하면 스킬이 자동으로 호출됩니다.
- 시뮬레이션 확인:
uv run --with "opentrons==9.1.1" opentrons_simulate protocol.py(OT-2는opentrons==9.0.0). - 실제 로봇 실행 전에는 반드시 Opentrons App에서 분석을 통과시키고, 운영자와 함께 드라이런을 진행하세요.
GitHub에서 원본 보기 ↗라이선스: MIT