← Back to Skills Marketplace
davidzhangbj

seekdb

by oceanbase · GitHub ↗ · v0.2.0 · MIT-0
cross-platform ⚠ suspicious
2525
Downloads
2
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install seekdb
Description
Operate seekdb via CLI commands and look up seekdb documentation. Use when: executing SQL, exploring table schemas, managing vector collections, registering...
Usage Guidance
This skill appears to do what it says (operate seekdb and fetch docs) but its runtime instructions ask the agent to discover connection info by reading environment files and local config/db files that are not declared in the manifest, and it suggests running a curl|bash installer hosted on an S3 URL. Before installing or using it: (1) don't run curl | sudo bash from unverified S3 URLs — prefer vetted packages or official release pages; (2) confirm whether the agent will have access to ~/.seekdb, .env, or other local files and only allow that in an isolated/test environment; (3) if you must connect to remote databases, avoid storing credentials in global env or allow-read locations and prefer explicit DSNs you control; (4) ask the skill author to declare required config paths/env vars and to remove instructions that implicitly read unspecified user files. If you need help assessing specific commands (e.g., the installer URL), provide them and I can inspect further.
Capability Analysis
Type: OpenClaw Skill Name: seekdb Version: 0.2.0 The seekdb skill is a comprehensive database management tool for AI agents, providing capabilities for SQL execution, vector search, and AI model registration. It includes robust safety features such as mandatory row limits, write-protection flags, and automatic masking of sensitive fields (PII) in query results. While it references high-risk installation patterns (curl|bash) and performs remote network requests to fetch documentation from GitHub (raw.githubusercontent.com), these actions are well-documented and strictly aligned with the tool's purpose as a database CLI and documentation assistant.
Capability Assessment
Purpose & Capability
Name/description align with the instructions: the SKILL.md documents using seekdb-cli, running SQL, inspecting schemas, managing collections, and fetching documentation. However, the docs and examples assume additional local artifacts (a local docs catalog file and skill_dir references) and recommend multiple installation routes (pipx/pip, brew, apt, docker, and a curl | bash install script hosted on an S3 URL). The presence of an S3-hosted install command and local catalog expectations is not strictly required by the stated purpose and is worth questioning.
Instruction Scope
Runtime instructions instruct the agent to auto-discover connection info from environment variables, .env, ~/.seekdb/config.env, or a local DB file (~/.seekdb/seekdb.db) — but the skill metadata declares no required config paths or env vars. references/doc-examples.md explicitly tells the agent to read the SKILL.md to resolve a <skill_dir> and to search a local catalog file (references/seekdb-docs-catalog.jsonl) that is not present in the package. The skill also instructs fetching remote docs (raw.githubusercontent.com), which is expected for documentation but combined with local file reads and credential discovery creates scope creep and possible access to user secrets or local files beyond the skill manifest.
Install Mechanism
There is no formal install spec (instruction-only), which reduces some risk, but the SKILL.md recommends multiple install methods including pipx/pip, brew tap, apt, docker, and a direct curl | sudo bash to an S3 URL (https://obportal.s3.ap-southeast-1.amazonaws.com/...). A curl | bash from an S3 bucket (not an official, well-known release host) is higher risk if followed. The skill references official-looking sources (raw.githubusercontent.com, oceanbase images), but the S3 installer should be treated with caution.
Credentials
Metadata declares no required environment variables or config paths, yet the instructions explicitly tell the agent to read environment variables, .env files, ~/.seekdb/config.env, and a local DB file for auto-discovery of DSNs (which may include credentials). This mismatch means the skill's runtime behavior may access sensitive files/credentials that were not declared in the manifest.
Persistence & Privilege
always:false and no install spec mean the skill does not request forced permanent inclusion or elevated platform privilege. The skill does not request modifying other skills or global agent settings in the provided instructions.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install seekdb
  3. After installation, invoke the skill by name or use /seekdb
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.0
- Summary: Documentation improved and hybrid/semantic query triggers clarified. - Updated the description to include "vector/hybrid/semantic search questions" as valid triggers for using this skill. - Clarified vector workflow documentation: default query mode is now described as "hybrid (semantic + fulltext)" instead of just "semantic". - No changes to commands or functionality; documentation enhancements only.
v0.1.9
seekdb v0.1.9 expands from documentation lookup to full database and vector CLI operation. - seekdb is now both a documentation lookup and a database CLI skill (not just docs). - Added documentation and instructions for running SQL commands, managing schemas, collections, and AI models using seekdb-cli. - Detailed deployment, installation, and workflow guidance for both embedded and server modes. - Old documentation-only mode reworked; users can now fetch docs and execute database operations together. - Example and reference sections updated to cover new CLI commands and workflows. - Example workflow documentation file renamed: `references/examples.md` → `references/doc-examples.md`.
v0.1.8
- Switched to remote-only mode: documentation is now fetched on-demand from public URLs; local doc files and update scripts are removed. - Catalog search is unchanged; still uses a single local or remote JSONL file for path and description matching. - Catalog entries now include a `branch` field, which is used to generate the correct public doc URL. - Updated documentation and examples to clarify the remote access workflow and multi-version handling. - Removed references to any code execution, credential use, or subprocess requirements.
v0.1.5
seekdb-docs 0.1.5 - Improved clarity in SKILL.md workflow and guidelines, especially around when to use grep versus loading the full catalog. - Updated instructions to clarify grep as the preferred method for most keyword queries. - Added concise explanation for catalog search strategies and fallback handling. - Refined examples and step ordering for better usability and quick start guidance. - Enhanced documentation navigation by specifying where to find detailed workflow examples.
v0.1.4
**Summary: Local-first catalog/documentation search with dynamic path resolution, remote fallback, and improved usage instructions.** - Added dynamic skill directory path resolution to reliably access local catalog and documentation regardless of working directory. - Switched to a local-first strategy: use local catalog/docs (if present) with remote GitHub fallback for both catalog and documents. - Catalog is now a single JSONL file (1015 entries) optimized for keyword (grep) and semantic search. - New scripts/update_docs.sh added for optional local doc sync; full example workflows provided in references/examples.md. - Usage guidance updated: always resolve path via reading SKILL.md, prefer grep-based queries, load full catalog only for broad/complex queries, handle both local and remote sources.
v0.0.6
- Updated example documentation URLs to reflect new paths in the "Develop" section (e.g., vector and hybrid search examples). - No changes to core logic or features; documentation and usage instructions remain consistent. - Ensured alignment of example file paths with current remote documentation structure.
v0.0.5
- Removed all local documentation files and local fallback support (952 files deleted). - Switched documentation access to remote-only; all docs are now fetched from GitHub. - Updated skill description and usage instructions to reflect remote-only operation. - Added guidance for error handling when the remote documentation is unavailable.
v0.0.4
- Improved documentation access with a remote-first, local-fallback strategy for seeking seekdb documentation. - Clearly described catalog-driven matching: match user queries semantically to catalog descriptions and categories. - Outlined structured processes for remote and local documentation lookup, with consistent behavior within conversations. - Added sample usage scenarios and guidance for querying, integration, and fallback handling. - Provided directory structure details and quick reference for local and remote documentation paths.
Metadata
Slug seekdb
Version 0.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 8
Frequently Asked Questions

What is seekdb?

Operate seekdb via CLI commands and look up seekdb documentation. Use when: executing SQL, exploring table schemas, managing vector collections, registering... It is an AI Agent Skill for Claude Code / OpenClaw, with 2525 downloads so far.

How do I install seekdb?

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

Is seekdb free?

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

Which platforms does seekdb support?

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

Who created seekdb?

It is built and maintained by oceanbase (@davidzhangbj); the current version is v0.2.0.

💬 Comments