Clarity Submit
by @clarityprotocol
Submit a protein variant hypothesis to Clarity Protocol for validation and folding. Use when the user asks to submit a hypothesis, propose a protein variant,...
clawhub install clarity-submitπ About This Skill
name: clarity-submit description: > Submit a protein variant hypothesis to Clarity Protocol for validation and folding. Use when the user asks to submit a hypothesis, propose a protein variant, queue a fold, or investigate a mutation. Requires CLARITY_WRITE_KEY env var. Capabilities: submit hypothesis, check submission status. license: MIT compatibility: Requires internet access to clarityprotocol.io. Requires CLARITY_WRITE_KEY env var for write access. metadata: author: clarity-protocol version: "1.0.0" homepage: https://clarityprotocol.io
Clarity Submit Skill
Submit protein variant hypotheses to Clarity Protocol for automated validation and ColabFold structural prediction.
Quick Start
Submit a hypothesis:
python scripts/submit_hypothesis.py --protein SOD1 --variant A4V --rationale "ALS-linked mutation with unknown structural impact"
Submit with optional fields:
python scripts/submit_hypothesis.py --protein MAPT --variant P301L --rationale "Tau pathology in frontotemporal dementia" --wallet "YOUR_SOLANA_WALLET"
Check hypothesis status:
python scripts/check_status.py --id 42
Setup
Set your write API key:
export CLARITY_WRITE_KEY=your_write_key_here
Contact the Clarity Protocol team to request a write API key.
What Happens After Submission
1. Feasibility validation runs automatically against UniProt, ClinVar, gnomAD, and PubMed 2. If validated, the hypothesis is auto-queued for ColabFold structural prediction 3. Four AI research agents continuously monitor the variant for new findings 4. Results are available at the tracking URL returned after submission
Request Fields
--protein (required): Protein name (e.g., SOD1, MAPT, APP, SNCA)--variant (required): Variant notation (e.g., A4V, P301L, G2019S)--rationale (required): Why this variant is worth investigating (min 10 characters)--disease (optional): Disease area (auto-detected from protein if omitted)--wallet (optional): Solana wallet address for $FOLD reward eligibilityResponse Fields
id: Unique hypothesis identifierprotein_name: Normalized protein namevariant_notation: Variant as submittedstatus: Current status (submitted, validating, validated, queued, folding, complete, rejected)tracking_url: URL to track progress on clarityprotocol.ioRate Limits
Size Limits
Proteins up to 1,500 residues can be folded. Larger proteins (e.g., LRRK2 at 2,527 residues) exceed hardware capacity and will be rejected during validation.
Error Handling
403 Forbidden: Invalid or missing write API key. Set CLARITY_WRITE_KEY env var.
422 Validation Error: Invalid input (protein name empty, rationale too short, etc.).
429 Rate Limit: You've exceeded 10 submissions/day. Wait until tomorrow.
Use Cases
β‘ When to Use
π‘ Examples
Submit a hypothesis:
python scripts/submit_hypothesis.py --protein SOD1 --variant A4V --rationale "ALS-linked mutation with unknown structural impact"
Submit with optional fields:
python scripts/submit_hypothesis.py --protein MAPT --variant P301L --rationale "Tau pathology in frontotemporal dementia" --wallet "YOUR_SOLANA_WALLET"
Check hypothesis status:
python scripts/check_status.py --id 42
βοΈ Configuration
Set your write API key:
export CLARITY_WRITE_KEY=your_write_key_here
Contact the Clarity Protocol team to request a write API key.