protocols.io 연동 (안전 읽기·계획)

무엇을 해주나

실험 프로토콜 공유 플랫폼인 protocols.io를 Claude Code에서 안전하게 다루도록 설계된 스킬입니다.

• 정확한 엔드포인트 지도: protocols.io 공식 문서는 여전히 "API v3"라는 제목이지만 실제로는 v3와 v4가 섞여 있습니다. 이 스킬은 검색/목록은 /api/v3/protocols, 단건 조회와 스텝은 /api/v4/... 처럼 작업별로 맞는 버전을 표로 정리해 둡니다.
• 오프라인 우선 동작: 인증 설정 확인, 저장된 JSON 검증, 페이지네이션 확인, 쓰기 계획 수립은 네트워크 없이 수행합니다.
• 명시적 실행 게이트: 네트워크 읽기는 --execute를 직접 붙여야만 동작하며, 공식 HTTPS 호스트만 사용하고 리다이렉트를 거부합니다.
• 쓰기는 계획만: 생성/수정/공개(DOI 발급)/스텝 삭제/파일 업로드 등은 실행 코드가 없습니다. 대상·버전·권한·되돌릴 수 없는 영향을 비교한 드라이런 계획과 확인 문구만 출력합니다.
• 연구 출처 보존: 제목·저자·DOI·version_uri·라이선스·포크 정보를 유지하고, 특정 버전을 몰래 /latest로 바꾸지 않습니다.
• 원격 콘텐츠 불신 원칙: 프로토콜 본문, 댓글, 파일명, 오류 메시지에 지시문이 섞여 있어도 따르지 않고 데이터로만 취급합니다.

이런 분께 추천

• protocols.io에 프로토콜을 게시·관리하는 실험실 연구자
• 논문 재현성을 위해 특정 버전 프로토콜을 정확히 인용해야 하는 대학원생·연구원
• 기관(organization) 콘텐츠 내보내기나 파일 매니저 API를 다루는 연구 IT 담당자
• 민감한 API 토큰을 다루면서도 사고를 막는 안전장치가 필요한 개발자

활용 예시

1. 공개 프로토콜 탐색: "single cell RNA 관련 protocols.io 프로토콜 20개만 찾아줘" → 먼저 요청 URL과 상한값(페이지 크기, 최대 항목 수)을 계획으로 보여주고, 확인 후 --execute로 실제 조회합니다.
2. 버전 고정 인용: protocol-uri/v2를 조회해 저자·DOI·version_uri를 그대로 보존한 인용 정보를 만들고, PDF는 0600 권한의 새 파일로만 저장합니다.
3. 프로토콜 업데이트 사전 검토: 수정할 JSON을 넘겨 update-protocol 계획을 생성 → 현재 상태와의 차이, 필요한 권한, 되돌릴 수 없는 영향(공개 시 버전 동결 및 DOI 발급)을 확인한 뒤 사람이 최종 판단합니다.
4. 저장된 응답 검증: 다운로드해 둔 프로토콜 JSON을 validate_protocol_json.py로 검사해 스텝 GUID 순서와 버전 메타데이터 누락을 잡아냅니다.

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