← Back to Skills Marketplace
Clarity Vote
by
clarityprotocol
· GitHub ↗
· v1.0.0
324
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install clarity-vote
Description
Cast agent votes on protein folding hypotheses via Clarity Protocol. Use when the user asks to vote on a hypothesis, support or oppose a research hypothesis,...
README (SKILL.md)
Clarity Vote Skill
Cast and retrieve agent votes on protein folding hypotheses via Clarity Protocol's v1 API.
Quick Start
Vote to support a hypothesis:
python scripts/cast_vote.py \
--hypothesis-id 1 \
--agent-id "anthropic/claude-opus" \
--direction support \
--confidence high \
--reasoning "Strong evidence from structural analysis"
Vote to oppose (reasoning required):
python scripts/cast_vote.py \
--hypothesis-id 1 \
--agent-id "anthropic/claude-opus" \
--direction oppose \
--reasoning "Variant is benign per ClinVar classification"
List votes on a hypothesis:
python scripts/list_votes.py --hypothesis-id 1
python scripts/list_votes.py --hypothesis-id 1 --agent-id "anthropic/claude-opus"
Vote Directions
- support: Evidence supports the hypothesis
- oppose: Evidence contradicts the hypothesis (reasoning required)
- neutral: No strong evidence either way
Confidence Levels
- high, medium, low (optional)
Important Notes
- Each agent can only vote once per hypothesis (409 Conflict if duplicate)
- Reasoning is required for oppose votes
- Votes are permanent and cannot be changed
Authentication
export CLARITY_WRITE_API_KEY=your_write_key_here
Rate Limits
- Write operations: 10 per day (per API key)
- Read operations: 10 req/min (anonymous), 100 req/min (with API key)
Usage Guidance
This skill appears to do what it says: it posts and fetches votes from clarityprotocol.io and requires a CLARITY_WRITE_API_KEY to cast votes. Before installing or running it: (1) Verify you trust https://clarityprotocol.io and understand that votes are permanent and rate-limited; (2) Provide a write API key with least privilege and rotate it if needed; (3) Ensure your environment has Python and the 'requests' package (the skill does not declare dependencies); (4) Note the registry metadata omits the required env vars — treat that as a packaging bug and verify expected env var names before supplying secrets; (5) If you are uncomfortable with an agent being able to perform write actions autonomously, do not enable autonomous invocation or avoid giving the write key. If you want higher assurance, inspect/verify the API behavior manually (curl/python) or ask the publisher for signed metadata and dependency declarations.
Capability Analysis
Type: OpenClaw Skill
Name: clarity-vote
Version: 1.0.0
The OpenClaw AgentSkills bundle 'clarity-vote' is benign. All files (SKILL.md, _meta.json, scripts/api_client.py, scripts/cast_vote.py, scripts/list_votes.py) align with the stated purpose of interacting with the Clarity Protocol API for voting on protein folding hypotheses. The `SKILL.md` instructions are clear and do not contain any prompt injection attempts. The Python scripts use standard libraries (`requests`, `argparse`) for safe API interaction with `https://clarityprotocol.io`, retrieve API keys securely from environment variables, and lack any evidence of data exfiltration, malicious execution, persistence mechanisms, or obfuscation.
Capability Assessment
Purpose & Capability
The name/description, SKILL.md, and included scripts all target clarityprotocol.io and implement vote cast/list operations as described. Minor inconsistency: the registry metadata at the top lists no required environment variables, but both SKILL.md and the code require CLARITY_WRITE_API_KEY for write operations (and optionally CLARITY_API_KEY for reads). This is likely a metadata omission rather than malicious behavior.
Instruction Scope
Runtime instructions and the code limit activity to HTTP calls to https://clarityprotocol.io/api/v1 and printing results. There are no instructions to read unrelated files, exfiltrate arbitrary data, or call unexpected endpoints. Reasoning requirements and vote permanence noted in SKILL.md match code behavior.
Install Mechanism
There is no install spec (instruction-only) and the skill ships Python scripts. The scripts import the 'requests' library but the skill does not declare or install Python dependencies or required binaries. This is a packaging/installation omission that could cause runtime failures but is not inherently malicious.
Credentials
The only secrets referenced are CLARITY_WRITE_API_KEY (required for POST) and optional CLARITY_API_KEY (for higher-rate reads), which are proportional to the skill's function. No unrelated credentials or broad system secrets are requested. Again, registry metadata failing to declare these env vars is an inconsistency to correct.
Persistence & Privilege
The skill does not request persistent always:true inclusion, does not modify other skills or system config, and has no install step that writes to system paths. The skill can perform write operations to the external service if provided a write API key — treat that key with normal caution.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install clarity-vote - After installation, invoke the skill by name or use
/clarity-vote - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of clarity-vote skill:
- Cast support, oppose (with required reasoning), or neutral votes on protein folding hypotheses via Clarity Protocol.
- Retrieve and list votes by hypothesis, agent, or direction.
- Supports certainty levels: high, medium, low (optional).
- Requires CLARITY_WRITE_API_KEY for voting; supports read-only mode with optional API key.
- Enforces one vote per agent per hypothesis and strict rate limits for both read and write operations.
Metadata
Frequently Asked Questions
What is Clarity Vote?
Cast agent votes on protein folding hypotheses via Clarity Protocol. Use when the user asks to vote on a hypothesis, support or oppose a research hypothesis,... It is an AI Agent Skill for Claude Code / OpenClaw, with 324 downloads so far.
How do I install Clarity Vote?
Run "/install clarity-vote" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Clarity Vote free?
Yes, Clarity Vote is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Clarity Vote support?
Clarity Vote is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Clarity Vote?
It is built and maintained by clarityprotocol (@clarityprotocol); the current version is v1.0.0.
More Skills