← Back to Skills Marketplace
clarityprotocol

Clarity Literature

by clarityprotocol · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
344
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install clarity-literature
Description
Search research papers and get publication details from Clarity Protocol. Use when the user asks to search research papers, find publications, PubMed referen...
README (SKILL.md)

Clarity Literature Skill

Search and retrieve research papers from Clarity Protocol's curated literature database, sourced from PubMed and enriched with citation metrics from Semantic Scholar.

Quick Start

List all papers in the database:

python scripts/search_papers.py

Get details for a specific paper by PMID:

python scripts/get_paper.py --pmid 12345678

Get paper details in readable format:

python scripts/get_paper.py --pmid 12345678 --format summary

Paper Fields

Each paper includes:

  • pmid: PubMed identifier
  • doi: Digital Object Identifier
  • title: Paper title
  • first_author: First author name
  • publication_year: Year published
  • journal: Journal name
  • abstract: Paper abstract (when available)
  • citation_count: Number of citations (from Semantic Scholar)
  • influential_citations: Number of highly influential citations
  • has_fulltext: Whether full text is available in PubMed Central

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/search_papers.py

Get your API key at https://clarityprotocol.io

Error Handling

404 Not Found: The paper with the specified PMID does not exist in the database.

429 Rate Limit: You've exceeded the rate limit. The script will display how long to wait.

500 Server Error: The API server encountered an error. Try again later.

Timeout: The request took longer than 30 seconds.

Pagination

Paper lists are paginated. The API returns a next_cursor field if more results are available.

Use Cases

  • Find research papers related to protein variants
  • Get citation metrics for a specific paper
  • Check if a paper has full text available
  • Extract abstracts for literature reviews
  • Build bibliographies for protein research
Usage Guidance
This skill appears to do exactly what it says: call clarityprotocol.io to list and fetch paper details. Before installing, verify clarityprotocol.io is the legitimate service you expect, and only set CLARITY_API_KEY if you trust that site. Ensure the runtime has the Python 'requests' package available (the scripts rely on it but no installer is provided). Review the included scripts (they are small and readable) and, if you run them on shared systems, avoid embedding sensitive data in search queries since queries are sent to the external API.
Capability Analysis
Type: OpenClaw Skill Name: clarity-literature Version: 1.0.0 The OpenClaw skill bundle is benign. It provides functionality to search and retrieve research papers from clarityprotocol.io, as explicitly stated in SKILL.md. The Python scripts (api_client.py, get_paper.py, search_papers.py) use the `requests` library to interact with the API, correctly handle an optional `CLARITY_API_KEY` from environment variables, and parse user input safely using `argparse` (e.g., `pmid` as an integer). There is no evidence of data exfiltration, malicious execution, persistence mechanisms, obfuscation, or prompt injection attempts against the AI agent in SKILL.md. All network communication is directed to the documented `https://clarityprotocol.io` domain.
Capability Assessment
✓ Purpose & Capability
Name/description, SKILL.md, and the three Python scripts consistently implement searching and retrieving papers from clarityprotocol.io. The API_BASE endpoint matches the documented homepage. No unrelated services, binaries, or credentials are requested.
✓ Instruction Scope
Runtime instructions tell the agent to run the provided scripts. The scripts only perform HTTP GETs to the Clarity Protocol API, print results, and handle common HTTP errors/rate limits. They do not read unrelated files, access other environment variables, or transmit data to endpoints other than clarityprotocol.io.
ℹ Install Mechanism
This is instruction-only with bundled Python scripts (no install spec). The scripts use the Python requests library, but no dependency installation is declared—users must ensure requests is available in the runtime. No remote downloads or archive extraction occur.
✓ Credentials
Only an optional CLARITY_API_KEY environment variable is mentioned for higher rate limits; the code reads that env var and uses it as an X-API-Key header. No other secrets or unrelated credentials are requested.
✓ Persistence & Privilege
always is false and the skill does not attempt to modify other skills or system-wide configuration. The skill does not request permanent privileges or write unexpected files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install clarity-literature
  3. After installation, invoke the skill by name or use /clarity-literature
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the clarity-literature skill. - Search for research papers and retrieve publication details from Clarity Protocol. - Supports querying by keywords and fetching paper details using PubMed ID (PMID). - Provides citation metrics, full-text availability, and paper metadata. - Allows up to 10 requests/min without an API key; 100 requests/min with an API key. - Includes error handling for not found, rate limits, server errors, and timeouts.
Metadata
Slug clarity-literature
Version 1.0.0
License —
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Clarity Literature?

Search research papers and get publication details from Clarity Protocol. Use when the user asks to search research papers, find publications, PubMed referen... It is an AI Agent Skill for Claude Code / OpenClaw, with 344 downloads so far.

How do I install Clarity Literature?

Run "/install clarity-literature" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Clarity Literature free?

Yes, Clarity Literature is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Clarity Literature support?

Clarity Literature is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Clarity Literature?

It is built and maintained by clarityprotocol (@clarityprotocol); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463942 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259883 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200739 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191401 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190375 · by oswalpalash

💬 Comments