{"id":"9257f0db-028b-40dc-8af5-82efc3e0a7be","entityType":"agent","slug":"clawhub-davidzhangbj-seekdb-docs","name":"seekdb","canonicalUrl":"https://www.xpersona.co/agent/clawhub-davidzhangbj-seekdb-docs","canonicalPath":"/agent/clawhub-davidzhangbj-seekdb-docs","generatedAt":"2026-10-09T06:44:50.507Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"description":"seekdb database documentation lookup. Use when users ask about seekdb features, SQL syntax, vector search, hybrid search, integrations, deployment, or any seekdb-related topics. Automatically locates relevant docs via catalog-based semantic search.","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.8K downloads reported by the source. Last updated 4/15/2026.","installCommand":"clawhub skill install kn7ajpckchvqztcwpmckyc9fxd80c3d5:seekdb-docs","sourceUrl":"https://clawhub.ai/davidzhangbj/seekdb-docs","homepage":"https://clawhub.ai/davidzhangbj/seekdb-docs","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/davidzhangbj/seekdb-docs","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":65,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"seekdb technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"stars":null,"forks":null,"downloads":1783,"packageName":null,"latestVersion":"0.1.5","tractionLabel":"1.8K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-02-28T20:16:01.156Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-02-28T20:16:01.156Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-01T20:16:01.156Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.5","createdAt":"2026-02-10T03:11:34.500Z","changelog":"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.","fileCount":4,"zipByteSize":7251},{"version":"0.1.4","createdAt":"2026-02-10T02:48:27.470Z","changelog":"**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.","fileCount":4,"zipByteSize":7114},{"version":"0.0.6","createdAt":"2026-02-03T06:58:54.203Z","changelog":"- 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.","fileCount":null,"zipByteSize":null},{"version":"0.0.5","createdAt":"2026-02-03T03:06:43.130Z","changelog":"- 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.","fileCount":null,"zipByteSize":null},{"version":"0.0.4","createdAt":"2026-02-02T07:10:00.781Z","changelog":"- 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.","fileCount":null,"zipByteSize":null}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install kn7ajpckchvqztcwpmckyc9fxd80c3d5:seekdb-docs","setupComplexity":"low","setupSteps":["Install using `clawhub skill install kn7ajpckchvqztcwpmckyc9fxd80c3d5:seekdb-docs` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/davidzhangbj/seekdb-docs before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-davidzhangbj-seekdb-docs/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-davidzhangbj-seekdb-docs/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-davidzhangbj-seekdb-docs/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-davidzhangbj-seekdb-docs/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-davidzhangbj-seekdb-docs/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-davidzhangbj-seekdb-docs/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T06:44:50.506Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-davidzhangbj-seekdb-docs/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-davidzhangbj-seekdb-docs/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-davidzhangbj-seekdb-docs/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-davidzhangbj-seekdb-docs/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"Skill: seekdb\n\nOwner: davidzhangbj\n\nSummary: seekdb database documentation lookup. Use when users ask about seekdb features, SQL syntax, vector search, hybrid search, integrations, deployment, or any seekdb-related topics. Automatically locates relevant docs via catalog-based semantic search.\n\nTags: latest:0.1.5\n\nVersion history:\n\nv0.1.5 | 2026-02-10T03:11:34.500Z | auto\n\nseekdb-docs 0.1.5\n\n- Improved clarity in SKILL.md workflow and guidelines, especially around when to use grep versus loading the full catalog.\n- Updated instructions to clarify grep as the preferred method for most keyword queries.\n- Added concise explanation for catalog search strategies and fallback handling.\n- Refined examples and step ordering for better usability and quick start guidance.\n- Enhanced documentation navigation by specifying where to find detailed workflow examples.\n\nv0.1.4 | 2026-02-10T02:48:27.470Z | auto\n\n**Summary: Local-first catalog/documentation search with dynamic path resolution, remote fallback, and improved usage instructions.**\n\n- Added dynamic skill directory path resolution to reliably access local catalog and documentation regardless of working directory.\n- Switched to a local-first strategy: use local catalog/docs (if present) with remote GitHub fallback for both catalog and documents.\n- Catalog is now a single JSONL file (1015 entries) optimized for keyword (grep) and semantic search.\n- New scripts/update_docs.sh added for optional local doc sync; full example workflows provided in references/examples.md.\n- 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.\n\nv0.0.6 | 2026-02-03T06:58:54.203Z | user\n\n- Updated example documentation URLs to reflect new paths in the \"Develop\" section (e.g., vector and hybrid search examples).\n- No changes to core logic or features; documentation and usage instructions remain consistent.\n- Ensured alignment of example file paths with current remote documentation structure.\n\nv0.0.5 | 2026-02-03T03:06:43.130Z | user\n\n- Removed all local documentation files and local fallback support (952 files deleted).\n- Switched documentation access to remote-only; all docs are now fetched from GitHub.\n- Updated skill description and usage instructions to reflect remote-only operation.\n- Added guidance for error handling when the remote documentation is unavailable.\n\nv0.0.4 | 2026-02-02T07:10:00.781Z | user\n\n- Improved documentation access with a remote-first, local-fallback strategy for seeking seekdb documentation.\n- Clearly described catalog-driven matching: match user queries semantically to catalog descriptions and categories.\n- Outlined structured processes for remote and local documentation lookup, with consistent behavior within conversations.\n- Added sample usage scenarios and guidance for querying, integration, and fallback handling.\n- Provided directory structure details and quick reference for local and remote documentation paths.\n\nArchive index:\n\nArchive v0.1.5: 4 files, 7251 bytes\n\nFiles: references/examples.md (9718b), scripts/update_docs.sh (1917b), SKILL.md (8240b), _meta.json (130b)\n\nFile v0.1.5:SKILL.md\n\n---\nname: seekdb-docs\ndescription: seekdb database documentation lookup. Use when users ask about seekdb features, SQL syntax, vector search, hybrid search, integrations, deployment, or any seekdb-related topics. Automatically locates relevant docs via catalog-based semantic search.\nversion: \"V1.1.0\"\n---\n\n# seekdb Documentation\n\nProvides comprehensive access to seekdb database documentation through a centralized catalog system.\n\n## Quick Start\n\n1. **Locate skill directory** (see Path Resolution below)\n2. **Load full catalog** (1015 documentation entries)\n3. **Match query** to catalog entries semantically\n4. **Read document** from matched entry\n\n## Path Resolution (Critical First Step)\n\n**Problem**: Relative paths like `./seekdb-docs/` are resolved from the **current working directory**, not from SKILL.md's location. This breaks when the agent's working directory differs from the skill directory.\n\n**Solution**: Dynamically locate the skill directory before accessing docs.\n\n### Step-by-Step Resolution\n\n1. **Read SKILL.md itself** to get its absolute path:\n   ```\n   read(SKILL.md)  // or any known file in this skill directory\n   ```\n\n2. **Extract the directory** from the returned path:\n   ```\n   If read returns: /root/test-claudecode-url/.cursor/skills/seekdb/SKILL.md\n   Skill directory: /root/test-claudecode-url/.cursor/skills/seekdb/\n   ```\n\n3. **Construct paths** using this directory:\n   ```\n   Catalog path: <skill directory>references/seekdb-docs-catalog.jsonl\n   Docs base: <skill directory>seekdb-docs/\n   ```\n\n## Documentation Sources\n\n### Full Catalog\n- **Local**: `<skill directory>references/seekdb-docs-catalog.jsonl` (1015 entries, JSONL format)\n- **Remote**: `https://raw.githubusercontent.com/oceanbase/seekdb-ecology-plugins/main/agent-skills/skills/seekdb/references/seekdb-docs-catalog.jsonl` (fallback)\n- **Entries**: 1015 documentation files\n- **Coverage**: Complete seekdb documentation\n- **Format**: JSONL - one JSON object per line with path and description\n\n### Complete Documentation (Local-First with Remote Fallback)\n\n**Local Documentation** (if available):\n- **Base Path**: `<skill directory>seekdb-docs/`\n- **Size**: 7.4M, 952 markdown files\n- **Document Path**: Base Path + File Path\n\n**Remote Documentation** (fallback):\n- **Base URL**: `https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/`\n- **Document URL**: Base URL + File Path\n\n**Strategy**:\n1. **Locate**: Determine `<skill directory>` using path resolution above\n2. **Load**: Load full catalog (1015 entries) - try local first, fallback to remote\n3. **Search**: Semantic search through all catalog entries\n4. **Read**: Try local docs first, fallback to remote URL if missing\n\n## Workflow\n\n### Step 0: Resolve Path (Do this first!)\n\n```bash\n# Read this file to discover its absolute path\nread(\"SKILL.md\")\n\n# Extract directory from the path\n# Example: /root/.claude/skills/seekdb/SKILL.md → /root/.claude/skills/seekdb/\n```\n\n### Step 1: Search Catalog\n\nStart with grep for keyword searches. Only load full catalog when necessary.\n\n#### Method 1: Grep Search (Preferred for 90% of queries)\n\nUse grep to search for keywords in the catalog:\n```bash\ngrep -i \"keyword\" <skill directory>references/seekdb-docs-catalog.jsonl\n```\n\n**Examples**:\n```bash\n# Find macOS deployment docs\ngrep -i \"mac\" references/seekdb-docs-catalog.jsonl\n\n# Find Docker deployment docs\ngrep -i \"docker\\|container\" references/seekdb-docs-catalog.jsonl\n\n# Find vector search docs\ngrep -i \"vector\" references/seekdb-docs-catalog.jsonl\n```\n\n#### Method 2: Load Full Catalog (Only when necessary)\n\nLoad the complete catalog only when:\n- Grep returns no results\n- Complex semantic matching is required\n- No specific keyword to search\n\n```\nLocal: <skill directory>references/seekdb-docs-catalog.jsonl\nRemote: https://raw.githubusercontent.com/oceanbase/seekdb-ecology-plugins/main/agent-skills/skills/seekdb/references/seekdb-docs-catalog.jsonl (fallback)\nFormat: JSONL (one JSON object per line)\nEntries: 1015 documentation files\n```\n\n**Strategy**:\n1. Try local catalog first: `<skill directory>references/seekdb-docs-catalog.jsonl`\n2. If local missing, fetch from remote URL above\n\n**Catalog contents**:\n- Each line: {\"path\": \"...\", \"description\": \"...\"}\n- All seekdb documentation indexed\n- Optimized for semantic search and grep queries\n\n### Step 2: Match Query\n\nAnalyze search results to identify the most relevant documents:\n\n**For grep results**:\n- Review matched lines from grep output\n- Extract `path` and `description` from each match\n- Select documents whose descriptions best match the query\n- Consider multiple matches for comprehensive answers\n\n**For full catalog**:\n- Parse each line as JSON to extract path and description\n- Perform semantic matching on description text\n- Match by meaning, not just keywords\n- Return all relevant entries for comprehensive answers\n\nNote: The catalog contains `path` and `description` fields. The `description` field contains topic and feature keywords, making it suitable for both keyword and semantic matching.\n\n### Step 3: Read Document\n\n**Local-First Strategy**:\n\n1. **Try local first**: `<skill directory>seekdb-docs/[File Path]`\n   - If file exists → read locally (fast)\n   - If file missing → proceed to step 2\n\n2. **Fallback to remote**: `https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/[File Path]`\n   - Download from GitHub\n\n**Example**:\n```\nQuery: \"How to integrate with Claude Code?\"\n\n1. Resolve path: read(SKILL.md) → /root/.claude/skills/seekdb/SKILL.md\n   Skill directory : /root/.claude/skills/seekdb/\n\n2. Search catalog with grep:\n   grep -i \"claude code\" /root/.claude/skills/seekdb/references/seekdb-docs-catalog.jsonl\n\n3. Match query from grep results:\n   → Found: {\"path\": \"300.integrations/300.developer-tools/700.claude-code.md\",\n             \"description\": \"This guide explains how to use the seekdb plugin with Claude Code...\"}\n   → This matches the query, select this document\n\n4. Read doc:\n   Try: /root/.claude/skills/seekdb/seekdb-docs/300.integrations/300.developer-tools/700.claude-code.md\n   If missing: https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/300.integrations/300.developer-tools/700.claude-code.md\n```\n\n## Guidelines\n\n- **Always resolve path first**: Use the read-your-SKILL.md trick to get the absolute path\n- **Prefer grep for keyword queries**: Load full catalog only when grep returns nothing or semantic matching is needed\n- **Semantic matching**: Match by meaning, not just keywords\n- **Multiple matches**: Read all relevant entries for comprehensive answers\n- **Local-first with remote fallback**: Try local docs first, use remote URL if missing\n- **Optional local docs**: Run `scripts/update_docs.sh` to download full docs locally (faster)\n- **Offline capable**: With local docs present, works completely offline\n\n## Catalog Search Format\n\nThe catalog file is in **JSONL format** (one JSON object per line):\n\n```json\n{\"path\": \"path/to/document.md\", \"description\": \"Document description text\"}\n```\n\n**Searching the catalog**:\n\n- **Keyword search**: Use grep (see Step 1 examples). Each matched line contains both path and description.\n- **When grep is insufficient**: Read the full catalog, parse each line as JSON, then do semantic matching on descriptions.\n\n## Common Installation Paths\n\nThis skill may be installed at:\n- **Cursor**: `.cursor/skills/seekdb/`\n- **Claude Code**: `.claude/skills/seekdb/`\n- **Custom**: Any directory (path resolution handles this automatically)\n\n**Do not hardcode these paths**. Use the dynamic resolution method instead.\n\n## Detailed Examples\n\nSee [examples.md](references/examples.md) for complete workflow examples including:\n- Full catalog search scenarios\n- Local-first lookup scenarios\n- Remote fallback scenarios\n- Integration queries\n- Multi-turn conversations\n\n## Category Overview\n\n- **Get Started**: Quick start, basic operations, overview\n- **Development**: Vector search, hybrid search, AI functions, MCP, multi-model\n- **Integrations**: Frameworks, model platforms, developer tools, workflows\n- **Guides**: Deployment, management, security, OBShell, performance\n- **Reference**: SQL syntax, PL, error codes, SDK APIs\n- **Tutorials**: Step-by-step scenarios\n\nFile v0.1.5:_meta.json\n\n{\n  \"ownerId\": \"kn7ajpckchvqztcwpmckyc9fxd80c3d5\",\n  \"slug\": \"seekdb-docs\",\n  \"version\": \"0.1.5\",\n  \"publishedAt\": 1770693094500\n}\n\nFile v0.1.5:references/examples.md\n\n# seekdb Documentation Examples\n\nComplete workflow examples for common seekdb documentation queries using **local-first strategy**.\n\n## Example 1: Vector Search Query\n\n**User Query**: \"How do I use vector search in seekdb?\"\n\n**Process**:\n\n1. **Resolve skill directory**\n   ```\n   Read SKILL.md → /root/.claude/skills/seekdb/SKILL.md\n   Extract: skill directory = /root/.claude/skills/seekdb/\n   ```\n\n2. **Load catalog (local-first)**\n   ```\n   Try local: /root/.claude/skills/seekdb/references/seekdb-docs-catalog.jsonl\n   Result: Success ✅\n   ```\n\n3. **Search catalog for vector search**\n   - Parse JSONL entries\n   - Query: \"vector search\"\n   - Found matches:\n     ```json\n     {\"path\": \"200.develop/600.search/300.vector-search/100.vector-search-intro.md\",\n      \"description\": \"This document provides an overview of vector search in seekdb, covering core concepts, supported vector data types, indexing methods, and search operations.\"}\n     {\"path\": \"200.develop/600.search/300.vector-search/300.vector-similarity-search.md\",\n      \"description\": \"This document explains vector similarity search methods in seekdb...\"}\n     ```\n\n4. **Read documents (local-first)**\n   - Try local: `/root/.claude/skills/seekdb/seekdb-docs/200.develop/600.search/300.vector-search/100.vector-search-intro.md`\n   - If missing → Remote: `https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/200.develop/600.search/300.vector-search/100.vector-search-intro.md`\n\n5. **Provide answer**\n\n---\n\n## Example 2: Basic Overview Query\n\n**User Query**: \"What is seekdb?\"\n\n**Process**:\n\n1. **Resolve skill directory**\n   ```\n   Read SKILL.md → get absolute path\n   Extract skill directory\n   ```\n\n2. **Load catalog**\n   ```\n   Local: <skill directory>references/seekdb-docs-catalog.jsonl\n   Success ✅\n   ```\n\n3. **Search catalog for overview**\n   - Query: \"seekdb overview\" or \"what is seekdb\"\n   - Found entry:\n     ```json\n     {\"path\": \"100.get-started/10.seekdb-overview/10.seekdb-overview.md\",\n      \"description\": \"An AI-native search database that unifies relational, vector, text, JSON, and GIS data in a single engine, enabling hybrid search and in-database AI workflows with full MySQL compatibility.\"}\n     ```\n\n4. **Read document**\n   - Local: `<skill directory>seekdb-docs/100.get-started/10.seekdb-overview/10.seekdb-overview.md`\n   - Success ✅\n\n5. **Extract answer** from local docs\n\n---\n\n## Example 3: Remote Fallback Scenario\n\n**User Query**: \"How do I deploy seekdb on macOS?\"\n\n**Process**:\n\n1. **Resolve skill directory**\n   ```\n   Read SKILL.md → /path/to/skills/seekdb/SKILL.md\n   Skill directory = /path/to/skills/seekdb/\n   ```\n\n2. **Load catalog (local-first)**\n   ```\n   Try local: /path/to/skills/seekdb/references/seekdb-docs-catalog.jsonl\n   Result: File not found ❌\n   ```\n\n3. **Fallback to remote catalog**\n   ```\n   Fetch: https://raw.githubusercontent.com/oceanbase/seekdb-ecology-plugins/main/agent-skills/skills/seekdb/references/seekdb-docs-catalog.jsonl\n   Result: Success ✅\n   ```\n\n4. **Search catalog**\n   - Query: \"macOS\", \"deploy\", \"systemd\"\n   - Found entry:\n     ```json\n     {\"path\": \"400.guides/400.deploy/700.server-mode/100.deploy-by-systemd.md\",\n      \"description\": \"This document provides instructions for deploying and managing the seekdb database using systemd on RPM-based, DEB-based, and macOS systems, covering installation, configuration, connection, and removal procedures.\"}\n     ```\n\n5. **Read document (remote only, since local missing)**\n   ```\n   URL: https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/400.guides/400.deploy/700.server-mode/100.deploy-by-systemd.md\n   Fetch and parse\n   ```\n\n6. **Provide answer**\n\n---\n\n## Example 4: Integration Query\n\n**User Query**: \"I want to integrate seekdb with Claude Code\"\n\n**Process**:\n\n1. **Resolve path & load catalog** (local success)\n\n2. **Search catalog for integration**\n   - Query: \"Claude Code\", \"integration\", \"AI coding\"\n   - Found entry:\n     ```json\n     {\"path\": \"100.get-started/200.ai-coding/200.building-an-ai-programming-assistant-that-understands-vector-databases-with-seekdb-claude-code.md\",\n      \"description\": \"This tutorial explains how to build a vector-aware AI coding assistant by integrating the seekdb plugin with Claude Code, enabling accurate documentation retrieval and hybrid search application development in Python.\"}\n     ```\n\n3. **Read document** (local)\n\n4. **Extract integration steps** and provide code examples\n\n---\n\n## Example 5: SQL Syntax Query\n\n**User Query**: \"What's the syntax for creating a vector column?\"\n\n**Process**:\n\n1. **Resolve path & load catalog** (local success)\n\n2. **Search for SQL/vector column syntax**\n   - Query: \"vector column\", \"CREATE TABLE\", \"vector type\"\n   - Found entry:\n     ```json\n     {\"path\": \"200.develop/600.search/300.vector-search/150.vector-data-type.md\",\n      \"description\": \"This document describes seekdb's vector data types for AI vector search, covering storage of dense and sparse floating-point arrays, index creation, and hybrid search capabilities.\"}\n     ```\n\n3. **Read document** (local)\n\n4. **Provide syntax** with examples\n\n---\n\n## Example 6: Hybrid Search Query\n\n**User Query**: \"How does hybrid search work?\"\n\n**Process**:\n\n1. **Resolve path & load catalog** (local success)\n\n2. **Search for hybrid search**\n   - Query: \"hybrid search\", \"combined search\"\n   - Found entry:\n     ```json\n     {\"path\": \"200.develop/600.search/500.hybrid-search.md\",\n      \"description\": \"This document describes hybrid search in seekdb, combining vector-based semantic search and full-text keyword search for more accurate results through integrated ranking.\"}\n     ```\n\n3. **Read document** (local)\n\n4. **Explain hybrid search concepts** with usage examples\n\n---\n\n## Example 7: Multiple Matches Query\n\n**User Query**: \"Tell me about seekdb indexes\"\n\n**Process**:\n\n1. **Resolve path & load catalog** (local success)\n\n2. **Search for all index types**\n   - Query: \"index\"\n   - Found multiple matches:\n     ```json\n     {\"path\": \"200.develop/600.search/300.vector-search/200.vector-index/100.vector-index-overview.md\", \"description\": \"...vector index types...\"}\n     {\"path\": \"200.develop/200.design-database-schema/35.multi-model/300.char-and-text/300.full-text-index.md\", \"description\": \"This document details the creation and use of full-text indexes in seekdb, covering supported column types, tokenizers, and complex DML operations on indexed tables.\"}\n     {\"path\": \"200.develop/200.design-database-schema/40.create-index-in-develop.md\", \"description\": \"...creating indexes...\"}\n     ```\n\n3. **Read all relevant documents** (local)\n\n4. **Provide comprehensive answer** covering:\n   - Vector indexes (HNSW, IVF)\n   - Full-text indexes\n   - Index creation syntax\n   - Best practices\n\n---\n\n## Example 8: Python SDK Query\n\n**User Query**: \"How do I use seekdb with Python?\"\n\n**Process**:\n\n1. **Resolve path & load catalog** (local success)\n\n2. **Search for Python SDK**\n   - Query: \"Python\", \"SDK\", \"pyseekdb\"\n   - Found entries:\n     ```json\n     {\"path\": \"100.get-started/50.use-seekdb-with-sdk/25.using-seekdb-in-python-sdk.md\",\n      \"description\": \"This document provides a step-by-step guide to using OceanBase's pyseekdb Python SDK for embedded seekdb operations...\"}\n     {\"path\": \"200.develop/100.connect-to-seekdb/300.sample-program/200.python/100.mysqlclient-connection-to-seekdb-sample-program.md\", \"description\": \"This document provides a sample program demonstrating how to connect to seekdb using mysqlclient in Python, including steps for creating tables, inserting data, and querying data.\"}\n     ```\n\n3. **Read documents** (local)\n\n4. **Provide Python setup** and code examples\n\n---\n\n## Example 9: Deployment Query\n\n**User Query**: \"How do I deploy seekdb in production?\"\n\n**Process**:\n\n1. **Resolve path & load catalog** (local success)\n\n2. **Search deployment guides**\n   - Query: \"production deployment\", \"install\"\n   - Found entries:\n     ```json\n     {\"path\": \"400.guides/400.deploy/50.deploy-overview.md\", \"description\": \"This documentation outlines seekdb's two deployment modes: embedded mode and server mode, and details the specific deployment methods available for each mode.\"}\n     ```\n\n3. **Read deployment guides** (local)\n\n4. **Extract deployment steps**:\n   - Prerequisites\n   - Installation methods\n   - Configuration\n   - Best practices\n\n---\n\n## Key Patterns\n\n### Path Resolution (Always First)\n1. Read SKILL.md to get absolute path\n2. Extract skill directory from path\n3. Construct catalog path: `<skill directory>references/seekdb-docs-catalog.jsonl`\n\n### Catalog Loading (Local-First)\n1. Try local catalog: `<skill directory>references/seekdb-docs-catalog.jsonl`\n2. If missing, fetch remote: `https://raw.githubusercontent.com/oceanbase/seekdb-ecology-plugins/main/agent-skills/skills/seekdb/references/seekdb-docs-catalog.jsonl`\n3. Parse JSONL (one JSON object per line)\n\n### Searching\n- **Semantic matching**: Match query meaning to description text\n- **Multiple results**: Read all relevant entries for comprehensive answers\n- **Fields available**: `path` and `description` only\n\n### Document Reading (Local-First)\n1. Try local: `<skill directory>seekdb-docs/[File Path]`\n2. If missing, fetch remote: `https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/[File Path]`\n\n### Best Practices\n- ✅ **Always resolve path first** - Never hardcode paths\n- ✅ **Local-first for speed** - Try local before remote\n- ✅ **Semantic over keyword** - Understand meaning, not just match words\n- ✅ **Read multiple sources** - Comprehensive answers from all relevant docs\n- ✅ **Parse JSONL correctly** - Each line is a valid JSON object with `path` and `description`\n\nArchive v0.1.4: 4 files, 7114 bytes\n\nFiles: references/examples.md (9092b), scripts/update_docs.sh (1917b), SKILL.md (8522b), _meta.json (130b)\n\nFile v0.1.4:SKILL.md\n\n---\nname: seekdb-docs\ndescription: seekdb database documentation lookup. Use when users ask about seekdb features, SQL syntax, vector search, hybrid search, integrations, deployment, or any seekdb-related topics. Automatically locates relevant docs via catalog-based semantic search.\nversion: \"V1.1.0\"\n---\n\n# seekdb Documentation\n\nProvides comprehensive access to seekdb database documentation through a centralized catalog system.\n\n## Quick Start\n\n1. **Locate skill directory** (see Path Resolution below)\n2. **Load full catalog** (1015 documentation entries)\n3. **Match query** to catalog entries semantically\n4. **Read document** from matched entry\n\n## Path Resolution (Critical First Step)\n\n**Problem**: Relative paths like `./seekdb-docs/` are resolved from the **current working directory**, not from SKILL.md's location. This breaks when the agent's working directory differs from the skill directory.\n\n**Solution**: Dynamically locate the skill directory before accessing docs.\n\n### Step-by-Step Resolution\n\n1. **Read SKILL.md itself** to get its absolute path:\n   ```\n   read(SKILL.md)  // or any known file in this skill directory\n   ```\n\n2. **Extract the directory** from the returned path:\n   ```\n   If read returns: /root/test-claudecode-url/.cursor/skills/seekdb/SKILL.md\n   Skill directory =: /root/test-claudecode-url/.cursor/skills/seekdb/\n   ```\n\n3. **Construct paths** using this directory:\n   ```\n   Catalog path =: <skill directory>references/seekdb-docs-catalog.jsonl\n   Docs base =: <skill directory>seekdb-docs/\n   ```\n\n## Documentation Sources\n\n### Full Catalog\n- **Local**: `<skill directory>references/seekdb-docs-catalog.jsonl` (1015 entries, JSONL format)\n- **Remote**: `https://raw.githubusercontent.com/oceanbase/seekdb-ecology-plugins/main/agent-skills/skills/seekdb/references/seekdb-docs-catalog.jsonl` (fallback)\n- **Entries**: 1015 documentation files\n- **Coverage**: Complete seekdb documentation\n- **Format**: JSONL - one JSON object per line with path and description\n\n### Complete Documentation (Local-First with Remote Fallback)\n\n**Local Documentation** (if available):\n- **Base Path**: `<skill directory>seekdb-docs/`\n- **Size**: 7.4M, 952 markdown files\n- **Document Path**: Base Path + File Path\n\n**Remote Documentation** (fallback):\n- **Base URL**: `https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/`\n- **Document URL**: Base URL + File Path\n\n**Strategy**:\n1. **Locate**: Determine `<skill directory>` using path resolution above\n2. **Load**: Load full catalog (1015 entries) - try local first, fallback to remote\n3. **Search**: Semantic search through all catalog entries\n4. **Read**: Try local docs first, fallback to remote URL if missing\n\n## Workflow\n\n### Step 0: Resolve Path (Do this first!)\n\n```bash\n# Read this file to discover its absolute path\nread(\"SKILL.md\")\n\n# Extract directory from the path\n# Example: /root/.claude/skills/seekdb/SKILL.md → /root/.claude/skills/seekdb/\n```\n\n### Step 1: Search Catalog\n\nStart with grep for keyword searches. Only load full catalog when necessary.\n\n#### Method 1: Grep Search (Preferred for 90% of queries)\n\nUse grep to search for keywords in the catalog:\n```bash\ngrep -i \"keyword\" <skill directory>references/seekdb-docs-catalog.jsonl\n```\n\n**Examples**:\n```bash\n# Find macOS deployment docs\ngrep -i \"mac\" references/seekdb-docs-catalog.jsonl\n\n# Find Docker deployment docs\ngrep -i \"docker\\|container\" references/seekdb-docs-catalog.jsonl\n\n# Find vector search docs\ngrep -i \"vector\" references/seekdb-docs-catalog.jsonl\n```\n\n#### Method 2: Load Full Catalog (Only when necessary)\n\nLoad the complete catalog only when:\n- Grep returns no results\n- Complex semantic matching is required\n- No specific keyword to search\n\n```\nLocal: <skill directory>references/seekdb-docs-catalog.jsonl\nRemote: https://raw.githubusercontent.com/oceanbase/seekdb-ecology-plugins/main/agent-skills/skills/seekdb/references/seekdb-docs-catalog.jsonl (fallback)\nFormat: JSONL (one JSON object per line)\nEntries: 1015 documentation files\n```\n\n**Strategy**:\n1. Try local catalog first: `<skill directory>references/seekdb-docs-catalog.jsonl`\n2. If local missing, fetch from remote URL above\n\n**Catalog contents**:\n- Each line: {\"path\": \"...\", \"description\": \"...\"}\n- All seekdb documentation indexed\n- Optimized for semantic search and grep queries\n\n### Step 2: Match Query\n\nAnalyze search results to identify the most relevant documents:\n\n**For grep results**:\n- Review matched lines from grep output\n- Extract `path` and `description` from each match\n- Select documents whose descriptions best match the query\n- Consider multiple matches for comprehensive answers\n\n**For full catalog**:\n- Parse each line as JSON to extract path and description\n- Perform semantic matching on description text\n- Match by meaning, not just keywords\n- Return all relevant entries for comprehensive answers\n\nNote: The catalog contains `path` and `description` fields. The `description` field contains topic and feature keywords, making it suitable for both keyword and semantic matching.\n\n### Step 3: Read Document\n\n**Local-First Strategy**:\n\n1. **Try local first**: `<skill directory>seekdb-docs/[File Path]`\n   - If file exists → read locally (fast)\n   - If file missing → proceed to step 2\n\n2. **Fallback to remote**: `https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/[File Path]`\n   - Download from GitHub\n\n**Example**:\n```\nQuery: \"How to integrate with Claude Code?\"\n\n1. Resolve path: read(SKILL.md) → /root/.claude/skills/seekdb/SKILL.md\n   Skill directory =: /root/.claude/skills/seekdb/\n\n2. Search catalog with grep:\n   grep -i \"claude code\" references/seekdb-docs-catalog.jsonl\n\n3. Match query from grep results:\n   → Found: {\"path\": \"300.integrations/300.developer-tools/700.claude-code.md\",\n             \"description\": \"This guide explains how to use the seekdb plugin with Claude Code...\"}\n   → This matches the query, select this document\n\n4. Read doc:\n   Try: /root/.claude/skills/seekdb/seekdb-docs/300.integrations/300.developer-tools/700.claude-code.md\n   If missing: https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/300.integrations/300.developer-tools/700.claude-code.md\n```\n\n## Guidelines\n\n- **Always resolve path first**: Use the read-your-SKILL.md trick to get the absolute path\n- **Always use full catalog**: Load complete catalog for comprehensive search (1015 entries)\n- **Semantic matching**: Match by meaning, not just keywords\n- **Multiple matches**: Read all relevant entries for comprehensive answers\n- **Local-first with remote fallback**: Try local docs first, use remote URL if missing\n- **Optional local docs**: Run `scripts/update_docs.sh` to download full docs locally (faster)\n- **Offline capable**: With local docs present, works completely offline\n\n## Catalog Search Format\n\nThe catalog file is in **JSONL format** (one JSON object per line):\n\n```json\n{\"path\": \"path/to/document.md\", \"description\": \"Document description text\"}\n```\n\n**Searching the catalog**:\n\n**Preferred method** - Read the full catalog:\n- Read the entire catalog file\n- Parse each line as JSON to extract path and description\n- Perform semantic matching on description text\n\n**Quick keyword search** - Use grep:\n```bash\ngrep -i \"keyword\" references/seekdb-docs-catalog.jsonl\n```\nEach matched line contains both path and description together.\n\n**Why JSONL is better**:\n- ✅ One line per document - grep shows complete information\n- ✅ Structured data - easy to parse with JSON tools\n- ✅ No special flags needed - works naturally with grep, jq, etc.\n\n## Common Installation Paths\n\nThis skill may be installed at:\n- **Cursor**: `.cursor/skills/seekdb/`\n- **Claude Code**: `.claude/skills/seekdb/`\n- **Custom**: Any directory (path resolution handles this automatically)\n\n**Do not hardcode these paths**. Use the dynamic resolution method instead.\n\n## Detailed Examples\n\nSee [examples.md](references/examples.md) for complete workflow examples including:\n- Full catalog search scenarios\n- Local-first lookup scenarios\n- Remote fallback scenarios\n- Integration queries\n- Multi-turn conversations\n\n## Category Overview\n\n- **Get Started**: Quick start, basic operations, overview\n- **Development**: Vector search, hybrid search, AI functions, MCP, multi-model\n- **Integrations**: Frameworks, model platforms, developer tools, workflows\n- **Guides**: Deployment, management, security, OBShell, performance\n- **Reference**: SQL syntax, PL, error codes, SDK APIs\n- **Tutorials**: Step-by-step scenarios\n\nFile v0.1.4:_meta.json\n\n{\n  \"ownerId\": \"kn7ajpckchvqztcwpmckyc9fxd80c3d5\",\n  \"slug\": \"seekdb-docs\",\n  \"version\": \"0.1.4\",\n  \"publishedAt\": 1770691707470\n}\n\nFile v0.1.4:references/examples.md\n\n# seekdb Documentation Examples\n\nComplete workflow examples for common seekdb documentation queries using **local-first strategy**.\n\n## Example 1: Vector Search Query\n\n**User Query**: \"How do I use vector search in seekdb?\"\n\n**Process**:\n\n1. **Resolve skill directory**\n   ```\n   Read SKILL.md → /root/.claude/skills/seekdb/SKILL.md\n   Extract: skill directory = /root/.claude/skills/seekdb/\n   ```\n\n2. **Load catalog (local-first)**\n   ```\n   Try local: /root/.claude/skills/seekdb/references/seekdb-docs-catalog.jsonl\n   Result: Success ✅\n   ```\n\n3. **Search catalog for vector search**\n   - Parse JSONL entries\n   - Query: \"vector search\"\n   - Found matches:\n     ```json\n     {\"path\": \"200.develop/600.search/300.vector-search/100.vector-search-intro.md\",\n      \"description\": \"This document provides an overview of vector search in seekdb, covering core concepts, supported vector data types, indexing methods, and search operations.\"}\n     {\"path\": \"200.develop/600.search/300.vector-search/300.vector-similarity-search.md\",\n      \"description\": \"This document explains vector similarity search methods in seekdb...\"}\n     ```\n\n4. **Read documents (local-first)**\n   - Try local: `/root/.claude/skills/seekdb/seekdb-docs/200.develop/600.search/300.vector-search/100.vector-search-intro.md`\n   - If missing → Remote: `https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/200.develop/600.search/300.vector-search/100.vector-search-intro.md`\n\n5. **Provide answer**\n\n---\n\n## Example 2: Basic Overview Query\n\n**User Query**: \"What is seekdb?\"\n\n**Process**:\n\n1. **Resolve skill directory**\n   ```\n   Read SKILL.md → get absolute path\n   Extract skill directory\n   ```\n\n2. **Load catalog**\n   ```\n   Local: <skill directory>references/seekdb-docs-catalog.jsonl\n   Success ✅\n   ```\n\n3. **Search catalog for overview**\n   - Query: \"seekdb overview\" or \"what is seekdb\"\n   - Found entry:\n     ```json\n     {\"path\": \"100.get-started/10.seekdb-overview/10.seekdb-overview.md\",\n      \"description\": \"An AI-native search database that unifies relational, vector, text, JSON, and GIS data in a single engine, enabling hybrid search and in-database AI workflows with full MySQL compatibility.\"}\n     ```\n\n4. **Read document**\n   - Local: `<skill directory>seekdb-docs/100.get-started/10.seekdb-overview/10.seekdb-overview.md`\n   - Success ✅\n\n5. **Extract answer** from local docs\n\n---\n\n## Example 3: Remote Fallback Scenario\n\n**User Query**: \"How do I deploy seekdb on macOS?\"\n\n**Process**:\n\n1. **Resolve skill directory**\n   ```\n   Read SKILL.md → /path/to/skills/seekdb/SKILL.md\n   Skill directory = /path/to/skills/seekdb/\n   ```\n\n2. **Load catalog (local-first)**\n   ```\n   Try local: /path/to/skills/seekdb/references/seekdb-docs-catalog.jsonl\n   Result: File not found ❌\n   ```\n\n3. **Fallback to remote catalog**\n   ```\n   Fetch: https://raw.githubusercontent.com/oceanbase/seekdb-ecology-plugins/main/agent-skills/skills/seekdb/references/seekdb-docs-catalog.jsonl\n   Result: Success ✅\n   ```\n\n4. **Search catalog**\n   - Query: \"macOS\", \"deploy\", \"systemd\"\n   - Found entry:\n     ```json\n     {\"path\": \"400.guides/200.deployment/500.deploy-with-systemd.md\",\n      \"description\": \"This document provides instructions for deploying and managing the seekdb database using systemd on RPM-based, DEB-based, and macOS systems...\"}\n     ```\n\n5. **Read document (remote only, since local missing)**\n   ```\n   URL: https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/400.guides/200.deployment/500.deploy-with-systemd.md\n   Fetch and parse\n   ```\n\n6. **Provide answer**\n\n---\n\n## Example 4: Integration Query\n\n**User Query**: \"I want to integrate seekdb with Claude Code\"\n\n**Process**:\n\n1. **Resolve path & load catalog** (local success)\n\n2. **Search catalog for integration**\n   - Query: \"Claude Code\", \"integration\", \"AI coding\"\n   - Found entry:\n     ```json\n     {\"path\": \"100.get-started/200.ai-coding/200.building-an-ai-programming-assistant-that-understands-vector-databases-with-seekdb-claude-code.md\",\n      \"description\": \"This tutorial explains how to build a vector-aware AI coding assistant by integrating the seekdb plugin with Claude Code, enabling accurate documentation retrieval and hybrid search application development in Python.\"}\n     ```\n\n3. **Read document** (local)\n\n4. **Extract integration steps** and provide code examples\n\n---\n\n## Example 5: SQL Syntax Query\n\n**User Query**: \"What's the syntax for creating a vector column?\"\n\n**Process**:\n\n1. **Resolve path & load catalog** (local success)\n\n2. **Search for SQL/vector column syntax**\n   - Query: \"vector column\", \"CREATE TABLE\", \"vector type\"\n   - Found entry:\n     ```json\n     {\"path\": \"200.develop/600.search/300.vector-search/150.vector-data-type.md\",\n      \"description\": \"This document describes seekdb's vector data types for AI vector search, covering storage of dense and sparse floating-point arrays, index creation, and hybrid search capabilities.\"}\n     ```\n\n3. **Read document** (local)\n\n4. **Provide syntax** with examples\n\n---\n\n## Example 6: Hybrid Search Query\n\n**User Query**: \"How does hybrid search work?\"\n\n**Process**:\n\n1. **Resolve path & load catalog** (local success)\n\n2. **Search for hybrid search**\n   - Query: \"hybrid search\", \"combined search\"\n   - Found entry:\n     ```json\n     {\"path\": \"200.develop/600.search/500.hybrid-search.md\",\n      \"description\": \"This document describes hybrid search in seekdb, combining vector-based semantic search and full-text keyword search for more accurate results through integrated ranking.\"}\n     ```\n\n3. **Read document** (local)\n\n4. **Explain hybrid search concepts** with usage examples\n\n---\n\n## Example 7: Multiple Matches Query\n\n**User Query**: \"Tell me about seekdb indexes\"\n\n**Process**:\n\n1. **Resolve path & load catalog** (local success)\n\n2. **Search for all index types**\n   - Query: \"index\"\n   - Found multiple matches:\n     ```json\n     {\"path\": \"200.develop/600.search/300.vector-search/200.vector-index/100.vector-index-overview.md\", \"description\": \"...vector index types...\"}\n     {\"path\": \"200.develop/300.read-and-write-data/200.read-data/300.full-text-index.md\", \"description\": \"...full-text indexes...\"}\n     {\"path\": \"200.develop/200.design-database-schema/40.create-index-in-develop.md\", \"description\": \"...creating indexes...\"}\n     ```\n\n3. **Read all relevant documents** (local)\n\n4. **Provide comprehensive answer** covering:\n   - Vector indexes (HNSW, IVF)\n   - Full-text indexes\n   - Index creation syntax\n   - Best practices\n\n---\n\n## Example 8: Python SDK Query\n\n**User Query**: \"How do I use seekdb with Python?\"\n\n**Process**:\n\n1. **Resolve path & load catalog** (local success)\n\n2. **Search for Python SDK**\n   - Query: \"Python\", \"SDK\", \"pyseekdb\"\n   - Found entries:\n     ```json\n     {\"path\": \"100.get-started/50.use-seekdb-with-sdk/25.using-seekdb-in-python-sdk.md\",\n      \"description\": \"This document provides a step-by-step guide to using OceanBase's pyseekdb Python SDK for embedded seekdb operations...\"}\n     {\"path\": \"200.develop/100.connect-to-seekdb/300.sample-program/200.python/...\", \"description\": \"...\"}\n     ```\n\n3. **Read documents** (local)\n\n4. **Provide Python setup** and code examples\n\n---\n\n## Example 9: Deployment Query\n\n**User Query**: \"How do I deploy seekdb in production?\"\n\n**Process**:\n\n1. **Resolve path & load catalog** (local success)\n\n2. **Search deployment guides**\n   - Query: \"production deployment\", \"install\"\n   - Found entries:\n     ```json\n     {\"path\": \"400.guides/200.deployment/...\", \"description\": \"...deployment instructions...\"}\n     ```\n\n3. **Read deployment guides** (local)\n\n4. **Extract deployment steps**:\n   - Prerequisites\n   - Installation methods\n   - Configuration\n   - Best practices\n\n---\n\n## Key Patterns\n\n### Path Resolution (Always First)\n1. Read SKILL.md to get absolute path\n2. Extract skill directory from path\n3. Construct catalog path: `<skill directory>references/seekdb-docs-catalog.jsonl`\n\n### Catalog Loading (Local-First)\n1. Try local catalog: `<skill directory>references/seekdb-docs-catalog.jsonl`\n2. If missing, fetch remote: `https://raw.githubusercontent.com/oceanbase/seekdb-ecology-plugins/main/agent-skills/skills/seekdb/references/seekdb-docs-catalog.jsonl`\n3. Parse JSONL (one JSON object per line)\n\n### Searching\n- **Semantic matching**: Match query meaning to description text\n- **Multiple results**: Read all relevant entries for comprehensive answers\n- **Fields available**: `path` and `description` only\n\n### Document Reading (Local-First)\n1. Try local: `<skill directory>seekdb-docs/[File Path]`\n2. If missing, fetch remote: `https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/[File Path]`\n\n### Best Practices\n- ✅ **Always resolve path first** - Never hardcode paths\n- ✅ **Local-first for speed** - Try local before remote\n- ✅ **Semantic over keyword** - Understand meaning, not just match words\n- ✅ **Read multiple sources** - Comprehensive answers from all relevant docs\n- ✅ **Parse JSONL correctly** - Each line is a valid JSON object with `path` and `description`","readmeExcerpt":"Skill: seekdb Owner: davidzhangbj Summary: seekdb database documentation lookup. Use when users ask about seekdb features, SQL syntax, vector search, hybrid search, integrations, deployment, or any seekdb-related topics. Automatically locates relevant docs via catalog-based semantic search. Tags: latest:0.1.5 Version history: v0.1.5 | 2026-02-10T03:11:34.500Z | auto seekdb-docs 0.1.5 - Improved clarity in SKILL.md wo","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"read(SKILL.md)  // or any known file in this skill directory"},{"language":"text","snippet":"If read returns: /root/test-claudecode-url/.cursor/skills/seekdb/SKILL.md\n   Skill directory: /root/test-claudecode-url/.cursor/skills/seekdb/"},{"language":"text","snippet":"Catalog path: <skill directory>references/seekdb-docs-catalog.jsonl\n   Docs base: <skill directory>seekdb-docs/"},{"language":"bash","snippet":"# Read this file to discover its absolute path\nread(\"SKILL.md\")\n\n# Extract directory from the path\n# Example: /root/.claude/skills/seekdb/SKILL.md → /root/.claude/skills/seekdb/"},{"language":"bash","snippet":"grep -i \"keyword\" <skill directory>references/seekdb-docs-catalog.jsonl"},{"language":"bash","snippet":"# Find macOS deployment docs\ngrep -i \"mac\" references/seekdb-docs-catalog.jsonl\n\n# Find Docker deployment docs\ngrep -i \"docker\\|container\" references/seekdb-docs-catalog.jsonl\n\n# Find vector search docs\ngrep -i \"vector\" references/seekdb-docs-catalog.jsonl"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: seekdb-docs\ndescription: seekdb database documentation lookup. Use when users ask about seekdb features, SQL syntax, vector search, hybrid search, integrations, deployment, or any seekdb-related topics. Automatically locates relevant docs via catalog-based semantic search.\nversion: \"V1.1.0\"\n---\n\n# seekdb Documentation\n\nProvides comprehensive access to seekdb database documentation through a centralized catalog system.\n\n## Quick Start\n\n1. **Locate skill directory** (see Path Resolution below)\n2. **Load full catalog** (1015 documentation entries)\n3. **Match query** to catalog entries semantically\n4. **Read document** from matched entry\n\n## Path Resolution (Critical First Step)\n\n**Problem**: Relative paths like `./seekdb-docs/` are resolved from the **current working directory**, not from SKILL.md's location. This breaks when the agent's working directory differs from the skill directory.\n\n**Solution**: Dynamically locate the skill directory before accessing docs.\n\n### Step-by-Step Resolution\n\n1. **Read SKILL.md itself** to get its absolute path:\n   ```\n   read(SKILL.md)  // or any known file in this skill directory\n   ```\n\n2. **Extract the directory** from the returned path:\n   ```\n   If read returns: /root/test-claudecode-url/.cursor/skills/seekdb/SKILL.md\n   Skill directory: /root/test-claudecode-url/.cursor/skills/seekdb/\n   ```\n\n3. **Construct paths** using this directory:\n   ```\n   Catalog path: <skill directory>references/seekdb-docs-catalog.jsonl\n   Docs base: <skill directory>seekdb-docs/\n   ```\n\n## Documentation Sources\n\n### Full Catalog\n- **Local**: `<skill directory>references/seekdb-docs-catalog.jsonl` (1015 entries, JSONL format)\n- **Remote**: `https://raw.githubusercontent.com/oceanbase/seekdb-ecology-plugins/main/agent-skills/skills/seekdb/references/seekdb-docs-catalog.jsonl` (fallback)\n- **Entries**: 1015 documentation files\n- **Coverage**: Complete seekdb documentation\n- **Format**: JSONL - one JSON object per line with path and description\n\n### Complete Documentation (Local-First with Remote Fallback)\n\n**Local Documentation** (if available):\n- **Base Path**: `<skill directory>seekdb-docs/`\n- **Size**: 7.4M, 952 markdown files\n- **Document Path**: Base Path + File Path\n\n**Remote Documentation** (fallback):\n- **Base URL**: `https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/`\n- **Document URL**: Base URL + File Path\n\n**Strategy**:\n1. **Locate**: Determine `<skill directory>` using path resolution above\n2. **Load**: Load full catalog (1015 entries) - try local first, fallback to remote\n3. **Search**: Semantic search through all catalog entries\n4. **Read**: Try local docs first, fallback to remote URL if missing\n\n## Workflow\n\n### Step 0: Resolve Path (Do this first!)\n\n```bash\n# Read this file to discover its absolute path\nread(\"SKILL.md\")\n\n# Extract directory from the path\n# Example: /root/.claude/skills/seekdb/SKILL.md → /root/.claude/skills/seekdb/\n```\n\n### Step 1: Search Catalog\n\nStart with grep for keyw"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7ajpckchvqztcwpmckyc9fxd80c3d5\",\n  \"slug\": \"seekdb-docs\",\n  \"version\": \"0.1.5\",\n  \"publishedAt\": 1770693094500\n}"},{"path":"references/examples.md","content":"# seekdb Documentation Examples\n\nComplete workflow examples for common seekdb documentation queries using **local-first strategy**.\n\n## Example 1: Vector Search Query\n\n**User Query**: \"How do I use vector search in seekdb?\"\n\n**Process**:\n\n1. **Resolve skill directory**\n   ```\n   Read SKILL.md → /root/.claude/skills/seekdb/SKILL.md\n   Extract: skill directory = /root/.claude/skills/seekdb/\n   ```\n\n2. **Load catalog (local-first)**\n   ```\n   Try local: /root/.claude/skills/seekdb/references/seekdb-docs-catalog.jsonl\n   Result: Success ✅\n   ```\n\n3. **Search catalog for vector search**\n   - Parse JSONL entries\n   - Query: \"vector search\"\n   - Found matches:\n     ```json\n     {\"path\": \"200.develop/600.search/300.vector-search/100.vector-search-intro.md\",\n      \"description\": \"This document provides an overview of vector search in seekdb, covering core concepts, supported vector data types, indexing methods, and search operations.\"}\n     {\"path\": \"200.develop/600.search/300.vector-search/300.vector-similarity-search.md\",\n      \"description\": \"This document explains vector similarity search methods in seekdb...\"}\n     ```\n\n4. **Read documents (local-first)**\n   - Try local: `/root/.claude/skills/seekdb/seekdb-docs/200.develop/600.search/300.vector-search/100.vector-search-intro.md`\n   - If missing → Remote: `https://raw.githubusercontent.com/oceanbase/seekdb-doc/V1.1.0/en-US/200.develop/600.search/300.vector-search/100.vector-search-intro.md`\n\n5. **Provide answer**\n\n---\n\n## Example 2: Basic Overview Query\n\n**User Query**: \"What is seekdb?\"\n\n**Process**:\n\n1. **Resolve skill directory**\n   ```\n   Read SKILL.md → get absolute path\n   Extract skill directory\n   ```\n\n2. **Load catalog**\n   ```\n   Local: <skill directory>references/seekdb-docs-catalog.jsonl\n   Success ✅\n   ```\n\n3. **Search catalog for overview**\n   - Query: \"seekdb overview\" or \"what is seekdb\"\n   - Found entry:\n     ```json\n     {\"path\": \"100.get-started/10.seekdb-overview/10.seekdb-overview.md\",\n      \"description\": \"An AI-native search database that unifies relational, vector, text, JSON, and GIS data in a single engine, enabling hybrid search and in-database AI workflows with full MySQL compatibility.\"}\n     ```\n\n4. **Read document**\n   - Local: `<skill directory>seekdb-docs/100.get-started/10.seekdb-overview/10.seekdb-overview.md`\n   - Success ✅\n\n5. **Extract answer** from local docs\n\n---\n\n## Example 3: Remote Fallback Scenario\n\n**User Query**: \"How do I deploy seekdb on macOS?\"\n\n**Process**:\n\n1. **Resolve skill directory**\n   ```\n   Read SKILL.md → /path/to/skills/seekdb/SKILL.md\n   Skill directory = /path/to/skills/seekdb/\n   ```\n\n2. **Load catalog (local-first)**\n   ```\n   Try local: /path/to/skills/seekdb/references/seekdb-docs-catalog.jsonl\n   Result: File not found ❌\n   ```\n\n3. **Fallback to remote catalog**\n   ```\n   Fetch: https://raw.githubusercontent.com/oceanbase/seekdb-ecology-plugins/main/agent-skills/skills/seekdb/references/seekdb-docs-catalog.jsonl\n   Result: Success ✅\n  "}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1229,"uniquenessScore":41,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T06:44:50.507Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}