← 返回 Skills 市场
Clarity Vote
作者
clarityprotocol
· GitHub ↗
· v1.0.0
324
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install 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,...
使用说明 (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)
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install clarity-vote - 安装完成后，直接呼叫该 Skill 的名称或使用
/clarity-vote触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
常见问题
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,... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 324 次。
如何安装 Clarity Vote？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install clarity-vote」即可一键安装，无需额外配置。
Clarity Vote 是免费的吗？
是的，Clarity Vote 完全免费（开源免费），可自由下载、安装和使用。
Clarity Vote 支持哪些平台？
Clarity Vote 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Clarity Vote？
由 clarityprotocol（@clarityprotocol）开发并维护，当前版本 v1.0.0。
推荐 Skills