clarity-literature
Search research papers and get publication details from Clarity Protocol. Use when the user asks to search research papers, find publications, PubMed references, literature about protein, or citation details. Capabilities: search papers, get paper details by PMID.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/clarityprotocol/clarity-literatureWhat This Skill Does
The clarity-literature skill acts as a powerful interface for accessing the vast repository of scientific knowledge curated by the Clarity Protocol. By bridging the gap between your AI agent and the PubMed/Semantic Scholar databases, this tool allows for seamless retrieval of biological and medical literature. Users can perform complex searches for specific research papers, extract detailed metadata including DOI, citation metrics, and publication years, or fetch full abstracts directly into their workflow. Whether you are conducting a rapid literature review or gathering bibliometric data on specific protein variants, this skill provides structured access to high-fidelity scientific data, ensuring your agent remains informed by the latest peer-reviewed evidence.
Installation
To integrate this skill into your OpenClaw environment, execute the following command in your terminal:
clawhub install openclaw/skills/skills/clarityprotocol/clarity-literature
Ensure that you have your environment configured correctly. If you require higher rate limits, generate an API key at https://clarityprotocol.io and set it as an environment variable using export CLARITY_API_KEY=your_key_here. This will elevate your capacity from 10 requests per minute to 100.
Use Cases
- Automated Literature Reviews: Automatically compile lists of papers and abstracts for specific research topics, such as protein folding or genetic mutations.
- Bibliometric Analysis: Extract citation counts and influential citation metrics to gauge the impact of a particular research paper.
- Full-Text Retrieval: Quickly determine if a paper is available via PubMed Central (PMC) to guide further reading or data extraction.
- Bibliography Management: Generate standardized citation details programmatically for research documents.
Example Prompts
- "Search for recent research papers related to the role of alpha-synuclein in neurodegenerative diseases."
- "Get the citation count and abstract for the paper with PMID 34567890."
- "Find ten papers published in 2023 that discuss mRNA vaccine technology and return their journal details."
Tips & Limitations
- Pagination: Large search results are paginated. Always check the
next_cursorfield if you need to fetch more than the initial result set. - Rate Limits: Respect the 10 requests/minute limit for anonymous users; if you encounter a 429 error, wait for the specified time before retrying.
- Timeouts: If you are performing intensive queries, be aware that requests have a 30-second timeout limit. If a query hangs, try refining your search parameters to return fewer results at once.
- Formatting: Use the
--format summaryflag with the script to get cleaner, more human-readable output compared to raw JSON data.
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-literature": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: external-api
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.