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.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/clarityprotocol/clarity-submitWhat This Skill Does
The clarity-submit skill serves as the primary bridge between the OpenClaw AI agent and the Clarity Protocol ecosystem. Its core function is to automate the submission of protein variant hypotheses for advanced scientific analysis. When invoked, the skill facilitates the transmission of protein identifiers and mutation data to the Clarity pipeline, which triggers a multi-stage validation process. This process includes cross-referencing with key biological databases like UniProt, ClinVar, and PubMed to assess the scientific validity of a hypothesis. Upon successful validation, the skill automatically queues the protein variant for ColabFold structural prediction. The output of this skill provides users with a unique tracking identifier and a URL, allowing them to monitor the lifecycle of their submission, from initial validation to the final structural output.
Installation
To integrate this skill into your environment, use the OpenClaw CLI tool. Ensure your system has the necessary permissions and that you have requested a unique write API key from the Clarity Protocol team. Install the package using the following command:
clawhub install openclaw/skills/skills/clarityprotocol/clarity-submit
Once installed, you must configure your environment variable to authorize the agent to perform submissions on your behalf:
export CLARITY_WRITE_KEY=your_write_key_here
Use Cases
- Automated Research Pipelines: Integrate variant submission into larger bioinformatics workflows to minimize manual data entry.
- Agent-Driven Discovery: Allow OpenClaw to suggest mutations based on literature review and immediately submit them for structural folding analysis.
- Batch Processing: Submit large lists of variants for systematic investigation without manual intervention.
- Incentivized Research: Attach Solana wallet addresses to submissions to participate in the $FOLD reward program, incentivizing the study of rare variants.
Example Prompts
- "Submit a hypothesis for the A4V mutation in the SOD1 protein; the rationale is its well-documented link to ALS progression."
- "I need to investigate the structural impact of the P301L variant in MAPT. Please submit this to Clarity and attach my wallet address 0x123... for rewards."
- "Check the status of my recent submission with ID 42 to see if the folding is complete."
Tips & Limitations
- Size Constraints: Be aware that the platform only supports proteins up to 1,500 residues. Attempting to submit larger proteins, such as LRRK2, will result in a rejection.
- Rate Limiting: Users are limited to 10 submissions per day. If you reach this limit, you must wait for the next calendar day to resume submissions.
- Data Quality: Ensure that your rationale is descriptive (at least 10 characters) to avoid validation errors. Higher quality rationales significantly improve the likelihood of successful system validation.
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-submit": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: external-api
Related Skills
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.
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.