Tích hợp protocols.io (đọc an toàn & lập kế hoạch)
Đọc, kiểm tra và xuất dữ liệu protocols.io theo đúng hợp đồng REST/MCP hiện hành, còn các thao tác ghi thì chỉ tạo kế hoạch chứ không thực thi.
Web · APINâng cao★ 33,030⑂ 3,248Điểm AI 8/10Cập nhật lần cuối: 9 thg 8, 2026
Nó làm được gì
Skill giúp Claude Code làm việc an toàn với protocols.io — nền tảng chia sẻ quy trình thí nghiệm.
- Bản đồ endpoint chính xác: Tài liệu chính thức vẫn mang tên "API v3" nhưng thực tế trộn cả v3 và v4. Skill lập bảng rõ ràng: tìm kiếm dùng
/api/v3/protocols, lấy chi tiết và các bước dùng/api/v4/..., PDF dùng/view/[id].pdf. - Ưu tiên chạy offline: kiểm tra cấu hình xác thực, validate JSON đã lưu, kiểm tra phân trang và lập kế hoạch ghi đều không cần mạng.
- Cổng
--executebắt buộc: mọi truy vấn mạng chỉ chạy khi bạn thêm--execute; chỉ dùng host HTTPS chính thức, từ chối redirect và không dùng proxy ngầm. - Ghi chỉ ở dạng kế hoạch: tạo, cập nhật, publish (cấp DOI), xóa bước, tải tệp... đều không có chế độ thực thi. Skill chỉ xuất kế hoạch dry-run kèm câu xác nhận.
- Giữ nguồn gốc khoa học: bảo toàn tiêu đề, tác giả, DOI,
version_uri, giấy phép; không âm thầm đổi bản lưu trữ thành/latest. - Coi nội dung remote là không đáng tin: văn bản quy trình, bình luận, tên tệp hay thông báo lỗi có thể chứa chỉ thị — skill chỉ trích dẫn, không tuân theo.
Dành cho ai
- Nhà nghiên cứu phòng thí nghiệm đăng và quản lý quy trình trên protocols.io
- Học viên cao học cần trích dẫn đúng phiên bản quy trình để bảo đảm tái lập
- Nhân sự IT nghiên cứu xử lý xuất nội dung tổ chức hoặc File Manager API
- Lập trình viên cần hàng rào an toàn khi làm việc với token API
Ví dụ sử dụng
- Tìm quy trình công khai: "Tìm 20 quy trình protocols.io về single cell RNA" → skill hiện URL và các giới hạn trước, sau khi bạn duyệt mới chạy với
--execute. - Trích dẫn cố định phiên bản: lấy
protocol-uri/v2, giữ nguyên tác giả, DOI,version_uri; PDF chỉ lưu vào tệp mới quyền0600. - Rà soát trước khi cập nhật: chạy
plan_write_request.py --operation update-protocolđể xem khác biệt so với trạng thái hiện tại, quyền cần thiết và hậu quả không thể hoàn tác trước khi con người quyết định. - Kiểm tra dữ liệu đã tải: dùng
validate_protocol_json.pyđể phát hiện thứ tự GUID của các bước sai hoặc thiếu metadata phiên bản.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/protocolsio-integration từ repo GitHub K-Dense-AI/scientific-agent-skills vào ~/.claude/skills/protocolsio-integration/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git && mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/protocolsio-integration ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và chuyển đến thư mục làm việc của bạn.
- Tải mã nguồn:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill này:
cp -r scientific-agent-skills/skills/protocolsio-integration ~/.claude/skills/ - Kiểm tra Python:
python3 --version(cần 3.11+, chỉ dùng thư viện chuẩn nên không phải cài thêm gì). - Nếu cần đọc dữ liệu riêng tư, đăng nhập protocols.io, lấy token ở trang Developer resources và đặt biến môi trường
PROTOCOLS_IO_ACCESS_TOKENqua cơ chế quản lý bí mật của máy. Đừng dán token vào chat hay dòng lệnh. - Kiểm tra offline:
python3 -B scripts/validate_auth_config.py --require read - Khởi động lại Claude Code và yêu cầu ví dụ "tìm quy trình trên protocols.io về ...". Chỉ các lệnh có
--executemới thực sự gọi mạng.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT