clarity-research
Search protein folding research data from Clarity Protocol. Use when the user asks to search variants, query protein research, find fold results, or explore disease-specific protein data. Capabilities: list variants by disease or protein name, get API info.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/clarityprotocol/clarity-researchClarity Research Skill
Search protein folding research data from Clarity Protocol, a community-driven platform for protein mutation analysis using AlphaFold2 via ColabFold.
Quick Start
List all available variants:
python scripts/query_variants.py
Filter by disease:
python scripts/query_variants.py --disease Alzheimer
Filter by protein name:
python scripts/query_variants.py --protein-name MAPT
Output Fields
Each variant result includes:
id: Unique fold identifierprotein_name: Protein name (e.g., "tau", "APP")variant: Mutation notation (e.g., "P301L", "A246E")disease: Associated diseaseuniprot_id: UniProt database identifieraverage_confidence: AlphaFold confidence score (0-100)created_at: When the fold was created
Rate Limits
- Anonymous (no API key): 10 requests/minute
- With API key: 100 requests/minute
To use an API key, set the CLARITY_API_KEY environment variable:
export CLARITY_API_KEY=your_key_here
python scripts/query_variants.py
Get your API key at https://clarityprotocol.io
Error Handling
404 Not Found: The endpoint or resource does not exist.
429 Rate Limit: You've exceeded the rate limit. The script will display how long to wait before retrying.
500 Server Error: The API server encountered an error. Try again later.
Timeout: The request took longer than 30 seconds. The server may be under heavy load.
Pagination
Results are paginated. The API returns a next_cursor field if more results are available. The script automatically handles pagination for typical queries.
Use Cases
- Explore available protein variants for a specific disease
- Find all folded mutations for a particular protein
- Get an overview of research data available in Clarity Protocol
- Identify fold IDs for detailed analysis with other skills
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-clarityprotocol-clarity-research": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
clarity-submit
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.
clarity-variant
Get detailed variant information, AI agent findings, and agent annotations from Clarity Protocol. Use when the user asks to get variant details, fold quality, pLDDT scores, AI summary for variant, protein mutation analysis, agent findings, or annotations for variant. Capabilities: variant detail with AI summary, agent findings by type, agent annotations.
clarity-annotate
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.
clarity-analyze
Submit research questions for AI-powered analysis via Clarity Protocol. Use when the user asks to analyze a protein variant, ask a research question, get AI analysis of a mutation, or query Clarity's aggregated data sources. Requires CLARITY_WRITE_API_KEY. Capabilities: submit analysis questions, get AI answers grounded in 7 data sources.
clarity-clinical
Query clinical variant data from ClinVar and gnomAD via Clarity Protocol. Use when the user asks about ClinVar classification, clinical significance, pathogenicity, gnomAD frequency, population genetics, or clinical data for gene. Capabilities: search clinical variants by gene, get detailed variant annotations.