HomeBrowseUpload
← Back to registry
// Skill profile

Clarity Annotate Skill

name: clarity-annotate

by clarityprotocol · published 2026-03-22

数据处理API集成加密货币
Total installs
0
Stars
★ 0
Last updated
2026-03
// Install command
$ claw add gh:clarityprotocol/clarityprotocol-clarity-annotate
View on GitHub
// Full documentation

---

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
  • // Comments
    Sign in with GitHub to leave a comment.
    // Related skills

    More tools from the same signal band