← Back to Skills Marketplace
carev01

Markdown Docs Full-Text Search

by carev01 · GitHub ↗ · v1.0.2
cross-platform ⚠ suspicious
459
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install md-docs-search
Description
Full-text search across structured Markdown documentation archives using SQLite FTS5. Use when you need to search large collections of Markdown articles that...
Usage Guidance
This bundle appears to be a straightforward local Markdown indexing/search tool. Before installing/running: 1) Confirm you will point the tool at an intended docs directory — it will read all *.md files recursively and create a SQLite DB (e.g., competitor_docs.db) in or near that directory. 2) Note there are no network calls or credential requests in the code, so it does not exfiltrate secrets. 3) The included code references 'competitor' and product names in comments and _meta.json (slug/version mismatch with the registry metadata) — this is likely repurposed code and not a functional risk, but you may want to verify the source if provenance matters. 4) Ensure your Python runtime has SQLite built with FTS5; otherwise searches may fail. 5) If you run it against very large directories, expect disk and CPU usage while building the index. If you need further assurance, run the scripts in a controlled environment (a temporary directory or container) to observe behavior and output before pointing them at sensitive folders.
Capability Analysis
Type: OpenClaw Skill Name: md-docs-search Version: 1.0.2 The skill bundle is designed for local documentation search and indexing, which is a benign purpose. However, it contains several vulnerabilities that make it suspicious. The most critical is a Regular Expression Denial of Service (ReDoS) risk in `scripts/search_docs.py`, where user-supplied search queries are directly compiled and executed as regex patterns, potentially leading to resource exhaustion. Additionally, the FTS5 search in `scripts/fts_search.py` could be vulnerable to Denial of Service via maliciously crafted complex queries, and the `db_path` argument across scripts allows for arbitrary file creation or overwrite, posing a file integrity risk.
Capability Assessment
Purpose & Capability
The name/description (Markdown full‑text search) matches the included scripts and SKILL.md: indexing, FTS5 search, source URL extraction and CLI helpers. Minor naming artifacts reference 'competitor' and specific product names (e.g., Commvault) in code/comments, but this appears to be reuse of an implementation rather than a capability mismatch.
Instruction Scope
SKILL.md instructs only local operations (index a docs directory, run searches, view status/get articles). The scripts perform file I/O on the provided docs_dir, compute hashes, build/inspect a local SQLite DB, and parse text — they do not make network requests or read unrelated system files or environment variables.
Install Mechanism
No install spec is provided (instruction-only skill with included scripts). Nothing is downloaded or installed automatically by the skill; code is bundled and runs locally. This is the lowest-risk install model.
Credentials
The skill requests no environment variables, credentials, or config paths. All required inputs are user-supplied (a documentation directory and optional db path).
Persistence & Privilege
The skill is not always-enabled and does not modify other skills or system-wide agent settings. It writes a local SQLite DB (by default into the docs directory or working directory), which is appropriate for an indexing tool.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install md-docs-search
  3. After installation, invoke the skill by name or use /md-docs-search
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
v1
v1.0.1
Generic search skill for Markdown docs
v1.0.0
Initial release - generic FTS5 search for structured Markdown documentation
Metadata
Slug md-docs-search
Version 1.0.2
License
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Markdown Docs Full-Text Search?

Full-text search across structured Markdown documentation archives using SQLite FTS5. Use when you need to search large collections of Markdown articles that... It is an AI Agent Skill for Claude Code / OpenClaw, with 459 downloads so far.

How do I install Markdown Docs Full-Text Search?

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

Is Markdown Docs Full-Text Search free?

Yes, Markdown Docs Full-Text Search is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Markdown Docs Full-Text Search support?

Markdown Docs Full-Text Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Markdown Docs Full-Text Search?

It is built and maintained by carev01 (@carev01); the current version is v1.0.2.

💬 Comments