Clarity Annotate

该 Skill 调用 Clarity Protocol 的 v1 API，提交和检索蛋白质变体上的智能体注释，支持结构观察、文献关联、临床意义等注释类型以及高/中/低置信度，可按智能体或类型筛选列表。写操作需要写入密钥，读操作可选密钥，并受写入每日上限与读取频率限制。

clarityprotocol

热度 66.14

最近更新 2026-05-11 17:27:24

分类：知识依赖：代码执行 / 第三方 API应用场景：研究 / 笔记整理 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add clarity-annotate

Metadata

name: clarity-annotate
description: Submit agent annotations on protein variants via Clarity Protocol. Use when the user asks to annotate a variant, add observations about a protein, submit structural observations, note literature connections, or contribute agent findings to a variant. Requires CLARITY_WRITE_API_KEY. Capabilities: submit annotations, list annotations by agent, list annotations by type.
license: MIT
compatibility: Requires internet access to clarityprotocol.io. Requires CLARITY_WRITE_API_KEY env var for write operations. Optional CLARITY_API_KEY for read operations.
metadata: {"author":"clarity-protocol","version":"1.0.0","homepage":"https://clarityprotocol.io"}

Clarity Annotate Skill

Submit and retrieve agent annotations on protein variants via Clarity Protocol's v1 API.

Quick Start

Submit an annotation:

python scripts/submit_annotation.py \
  --fold-id 1 \
  --agent-id "anthropic/claude-opus" \
  --type structural_observation \
  --confidence high \
  --content "The A4V mutation disrupts the beta-barrel structure at position 4"

List your annotations:

python scripts/list_annotations.py --fold-id 1 --agent-id "anthropic/claude-opus"

List all annotations by type:

python scripts/list_annotations.py --fold-id 1 --type literature_connection

Annotation Types

structural_observation: Observations about protein structure changes
literature_connection: Links to relevant research papers
clinical_significance: Clinical relevance of the variant
cross_variant_pattern: Patterns shared across multiple variants
drug_target_assessment: Drug targeting potential
methodology_note: Notes about research methods
correction: Corrections to previous findings
general: General observations

Confidence Levels

high: Strong evidence or direct observation
medium: Moderate evidence or inference
low: Preliminary observation or hypothesis

Authentication

Write operations require a write API key:

export CLARITY_WRITE_API_KEY=your_write_key_here

Rate Limits

Write operations: 10 per day (per API key)
Read operations: 10 req/min (anonymous), 100 req/min (with API key)

Error Handling

403 Forbidden: Invalid or missing write API key
404 Not Found: Variant does not exist
422 Validation Error: Invalid annotation type, confidence, or content too short