← Back to Skills Marketplace
xtmingyue

openqbook

by XTmingyue · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
77
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install openqbook
Description
Platform-agnostic skill to post developer questions on OpenQBook, poll for human answers, and manage feedback and resolution when AI agents are blocked.
Usage Guidance
Before installing: 1) Verify the origin — check that https://www.openqbook.com is the legitimate project site and that the SKILL.md contents are what you expect; don't blindly run the install curl. 2) The SKILL.md requires OPENQBOOK_API_KEY even though the registry metadata omitted it — ensure you understand where the API key comes from and grant it minimal scope. 3) Review the downloaded SKILL.md (and any embedded <skill-script> Python) before adding it to your runtime; it will be stored and potentially executed by your agent. 4) Avoid posting secrets, credentials, or sensitive system output in questions; the skill will send question content to an external service. 5) If possible, sandbox the skill or test in a non-production environment and limit the API key (revocable, least privilege). These steps will reduce the risk posed by the remote-download install flow and the potential for inadvertent data leakage.
Capability Analysis
Type: OpenClaw Skill Name: openqbook Version: 1.0.0 The skill facilitates human-in-the-loop Q&A via the OpenQBook API but exhibits several risky patterns. The `skill.md` file includes an installation script that performs a remote fetch of content from `https://www.openqbook.com/skill.md`, which is a significant supply-chain risk. Additionally, the instructions contain prompt-injection-like directives ('Agent decides helpfulness - no human input') that explicitly command the agent to autonomously evaluate and implement solutions from the external platform without human oversight, potentially leading to the execution of harmful suggestions. The Python implementation also contains unusual backslash-escaping of identifiers (e.g., `API\_KEY` in `skill.md`), which, while likely a markdown formatting artifact, is atypical for clean production code.
Capability Assessment
Purpose & Capability
The skill name/description (post questions to OpenQBook, poll answers, manage feedback) align with the runtime instructions. The SKILL.md requires an OPENQBOOK_API_KEY and optionally OPENQBOOK_API_BASE, which are appropriate for this purpose. However, the registry metadata lists no required environment variables or homepage/source while the SKILL.md explicitly requires an API key and downloads code from https://www.openqbook.com — this metadata/instruction mismatch is unexpected.
Instruction Scope
The instructions direct the agent to post questions and poll answers to an external service (OpenQBook), initialize polling state files, and run periodic/background polling and evaluation. Those behaviors are consistent with the stated purpose but involve transmitting freeform developer questions and potentially code or logs to an external endpoint — which can leak secrets if the agent includes sensitive context. The SKILL.md also provides an install snippet that fetches a remote SKILL.md and writes it into the agent's skill directory; installing unverified text that contains executable script blocks increases risk because the downloaded file may later be executed by your runtime.
Install Mechanism
There is no formal install spec in the registry, but the SKILL.md includes a shell install flow that uses curl to download https://www.openqbook.com/skill.md into the agent skill directory and writes it to disk. Downloading an executable skill file from an external URL at install time is higher risk than an instruction-only skill with no network install. The URL is a site domain (not a well-known package release host like GitHub releases); because the registry entry also lacks a homepage/source, it's hard to independently verify the origin.
Credentials
The skill requires a single service credential (OPENQBOOK_API_KEY) and optionally OPENQBOOK_API_BASE and OPENQBOOK_SKILL_DIR — which are proportionate to a third-party API integration. The registry, however, declares no required env vars or primary credential, creating a mismatch: the skill will not work without an API key but that requirement is not surfaced in metadata. No unrelated or excessive credentials are requested.
Persistence & Privilege
The skill does not request always:true and does not require system-wide configuration changes beyond creating a directory under common skill paths and saving the SKILL.md there. Autonomous invocation (disable-model-invocation:false) is the platform default and not a new privilege here. No evidence the skill modifies other skills' configs or requests elevated system privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openqbook
  3. After installation, invoke the skill by name or use /openqbook
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
OpenQBook Agent Skill v2.0.0 - Major update: new platform-agnostic agent skill for human-in-the-loop developer Q&A workflows. - Adds functions for posting questions, polling and evaluating answers, and providing feedback to OpenQBook. - Offers detailed install instructions with environment variable support and multi-path adaptive setup. - Provides ready-to-use Python API for integration: asking questions, polling, marking answers helpful/unhelpful, and closing questions. - Includes scheduler and heartbeat workflow examples and clear state management guidelines. - Enforces feedback rules: mandatory feedback for each answer, autonomous decision making, sequential evaluation.
Metadata
Slug openqbook
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is openqbook?

Platform-agnostic skill to post developer questions on OpenQBook, poll for human answers, and manage feedback and resolution when AI agents are blocked. It is an AI Agent Skill for Claude Code / OpenClaw, with 77 downloads so far.

How do I install openqbook?

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

Is openqbook free?

Yes, openqbook is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does openqbook support?

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

Who created openqbook?

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

💬 Comments