← Back to Skills Marketplace
Hybrid DB Health
by
cryptobro-man
· GitHub ↗
· v1.0.0
409
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install hybrid-db-health
Description
Validate and troubleshoot the hybrid database system used by OpenClaw agents (Pulse task DB + RAG Pinecone stack). Use when asked to check setup, connection...
README (SKILL.md)
Hybrid DB Health
Run a quick, reliable health check for the two database surfaces in this workspace:
When combined with shared-pinecone-rag, position the pair as a Persistent Memory skill stack (retrieval + health assurance).
- Pulse operational DB/sync layer in
agents/pulse - RAG Pinecone layer in
rag-pinecone-starter
Runbook
- Run the bundled script:
bash scripts/check_hybrid_db.sh
- Interpret status:
PASS: subsystem is configured and respondingWARN: subsystem exists but is not fully configuredFAIL: subsystem check execution failed
- Report to user in plain language:
- Pulse DB status
- RAG DB status
- Exact next fix steps if WARN/FAIL
Manual checks (if script unavailable)
Pulse DB
cd /home/Mike/.openclaw/workspace/agents/pulse
python3 openclaw_sync.py --check
Expected: Database connection OK
RAG Pinecone
cd /home/Mike/.openclaw/workspace/rag-pinecone-starter
[ -f .env ] && grep -E '^(OPENAI_API_KEY|PINECONE_API_KEY)=' .env
If either key is blank, report as not connected yet.
Optional live connectivity test (requires keys + deps):
source .venv/bin/activate
python query.py "connectivity test"
Output format
Return concise status like:
- Pulse DB: PASS/FAIL
- RAG Pinecone: PASS/WARN/FAIL
- Next steps: bullets
Usage Guidance
This skill appears to do what it says (check Pulse and Pinecone connectivity) but exercise caution before running it as-is. Specific actions to consider:
- Inspect the included script and, critically, the local Python files it will invoke (openclaw_sync.py and query.py) before running them — they may perform network requests or log secrets.
- Note the script hard-codes /home/Mike/.openclaw/workspace; update the path to your own workspace or run it from a controlled environment so it doesn't accidentally read another user's files.
- The script reads OPENAI_API_KEY and PINECONE_API_KEY from a .env file even though the skill declared no credential requirements; treat those keys as sensitive and avoid running live checks unless you trust the Python code and the environment (or run inside an isolated sandbox).
- If you only need a non-executing check, use the manual grep steps to verify presence of keys, or run the script after editing it to disable the live python query.
If you cannot review the invoked Python code, run these checks in a sandboxed container or reject installation.
Capability Analysis
Type: OpenClaw Skill
Name: hybrid-db-health
Version: 1.0.0
The skill is classified as suspicious due to the `scripts/check_hybrid_db.sh` file directly reading and parsing `OPENAI_API_KEY` and `PINECONE_API_KEY` from a local `.env` file. While the script does not explicitly exfiltrate these keys in its final output, the act of extracting sensitive credentials into shell variables for internal processing represents a high-risk capability. This could be a vulnerability if the script were modified or if the `query.py` script it calls were to log or expose these details, even if not intentionally malicious in its current form.
Capability Assessment
Purpose & Capability
The skill is described as a hybrid DB health checker and the bundled script performs the expected checks (Pulse sync script and a Pinecone/Query check). However the script uses a hard-coded workspace path (/home/Mike/.openclaw/workspace) and the registry metadata declares no required config paths, which is inconsistent and suggests the package was packaged for a specific user rather than being generally portable.
Instruction Scope
SKILL.md and the script instruct running local Python programs (openclaw_sync.py and query.py) and reading a .env file. Those runtime actions are within the stated purpose (connectivity and live query tests) but they also run arbitrary local code and surface command output. The instructions do not warn that the invoked Python scripts may execute network I/O or print sensitive values, and they reference absolute user-specific paths rather than a configurable workspace path.
Install Mechanism
This is an instruction-only skill with no install spec and no external downloads. The only code shipped is a small shell script. There is low install-supply-chain risk from this package itself.
Credentials
The manifest declares no required environment variables or config paths, but the script explicitly reads OPENAI_API_KEY and PINECONE_API_KEY from a .env file and may activate a venv and run query.py. That means the skill will access local credentials without declaring them, and running the referenced Python code could use those keys to contact external services — a credential exposure risk if you haven't reviewed the invoked Python code.
Persistence & Privilege
The skill does not request persistent presence (always=false) and does not modify system or other-skill configurations. It only runs checks and prints results, so requested privileges are minimal.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install hybrid-db-health - After installation, invoke the skill by name or use
/hybrid-db-health - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: health checks for Pulse DB and Pinecone RAG connectivity.
Metadata
Frequently Asked Questions
What is Hybrid DB Health?
Validate and troubleshoot the hybrid database system used by OpenClaw agents (Pulse task DB + RAG Pinecone stack). Use when asked to check setup, connection... It is an AI Agent Skill for Claude Code / OpenClaw, with 409 downloads so far.
How do I install Hybrid DB Health?
Run "/install hybrid-db-health" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Hybrid DB Health free?
Yes, Hybrid DB Health is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Hybrid DB Health support?
Hybrid DB Health is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Hybrid DB Health?
It is built and maintained by cryptobro-man (@cryptobro-man); the current version is v1.0.0.
More Skills