# Send Markdown Docs Full-Text Search to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "md-docs-search",
    "name": "Markdown Docs Full-Text Search",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/carev01/md-docs-search",
    "canonicalUrl": "https://clawhub.ai/carev01/md-docs-search",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/md-docs-search",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=md-docs-search",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "references/search-patterns.md",
      "scripts/docs.py",
      "scripts/fts_search.py",
      "scripts/get_article.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "md-docs-search",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T08:00:21.085Z",
      "expiresAt": "2026-05-07T08:00:21.085Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=md-docs-search",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=md-docs-search",
        "contentDisposition": "attachment; filename=\"md-docs-search-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "md-docs-search"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/md-docs-search"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/md-docs-search",
    "downloadUrl": "https://openagent3.xyz/downloads/md-docs-search",
    "agentUrl": "https://openagent3.xyz/skills/md-docs-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/md-docs-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/md-docs-search/agent.md"
  }
}
```
## Documentation

### Markdown Documentation Full-Text Search

Fast, indexed full-text search across Markdown documentation archives using SQLite FTS5 with BM25 relevance ranking.

### When to Use

Searching documentation archives for specific features, capabilities, or information
Finding official source URLs to cite in reports
Looking up technical specifications or configuration details
Research across multiple documentation sources

### Document Format Expected

Articles separated by --- delimiter with *Source: URL:

# Article Title

*Source: https://docs.example.com/path/to/article.html*

Article content here...

---

# Next Article Title

*Source: https://docs.example.com/another/article.html*

More content...

### Quick Start

# 1. Index the documentation (one-time or when docs change)
scripts/docs.py index ./docs

# 2. Search
scripts/docs.py search "kubernetes backup" --max 5

# 3. Check index status
scripts/docs.py status

### Primary Tool: docs.py

The unified CLI handles all operations:

### Indexing

# Index documentation directory
scripts/docs.py index ./docs

# Force full rebuild
scripts/docs.py index ./docs --rebuild

# Custom database location
scripts/docs.py index ./docs --db /path/to/custom.db

### Searching

# Basic search
scripts/docs.py search "kubernetes backup"

# Boolean operators
scripts/docs.py search "AWS AND S3 AND snapshot"

# Phrase search
scripts/docs.py search '"exact phrase match"'

# Prefix search
scripts/docs.py search "kube*"

# Exclude terms
scripts/docs.py search "backup NOT restore"

# Title-only search
scripts/docs.py search "kubernetes" --title-only

# Output formats
scripts/docs.py search "kubernetes" --format json
scripts/docs.py search "kubernetes" --format markdown

# More context around matches
scripts/docs.py search "kubernetes" --context 400

# Include full content in JSON
scripts/docs.py search "kubernetes" --format json --full-content

### FTS5 Query Syntax

SyntaxMeaningterm1 term2Documents with term1 OR term2 (ranked)term1 AND term2Documents with both termsterm1 OR term2Documents with either term"exact phrase"Exact phrase matchprefix*Words starting with prefixterm1 NOT term2term1 without term2title:termSearch only titles

### Getting Specific Articles

# Get article by partial URL or title
scripts/docs.py get "system_requirements" --full

# Find all matching articles
scripts/docs.py get "backup" --all

### Status

# Check index statistics
scripts/docs.py status

### Discovery Phase

# Check what's indexed
scripts/docs.py status

# Explore topics with broad searches
scripts/docs.py search "<feature>" --max 20

### Research Phase

# Narrow down with boolean operators
scripts/docs.py search "<feature> AND <platform>"

# Find specific information
scripts/docs.py search "limitation OR restriction OR 'not supported'"

### Citation Phase

Every search result includes the Source: URL — use this in your reports:

According to documentation, [finding]...

Source: https://docs.example.com/path/to/article.html

### Multi-Source Setup

Each agent or project can have their own documentation and index:

~/docs/VendorA/
    ├── docs_part_01.md
    ├── docs.db      # Index lives with docs
    └── ...

~/docs/VendorB/
    ├── docs.md
    ├── docs.db
    └── ...

The docs.py script auto-detects the database location.

### Advanced Scripts

For specialized needs:

scripts/fts_search.py — Direct FTS5 search with more options
scripts/index_docs.py — Standalone indexing
scripts/list_sources.py — List all source URLs
scripts/get_article.py — Direct article retrieval
scripts/search_docs.py — Regex-based search (no index needed)

### Research Patterns

For common search patterns (feature research, architecture, security, etc.), see references/search-patterns.md.

### Example Session

# What's available?
scripts/docs.py status
# Output: Files indexed: 37, Articles indexed: 32065

# Find information
scripts/docs.py search "kubernetes backup" --max 5

# Narrow to specific platform
scripts/docs.py search "kubernetes AND AWS" --max 5

# Find limitations
scripts/docs.py search "limitation OR 'not supported'"

# Get full article for citation
scripts/docs.py get "system_requirements" --full

### Best Practices

Index once, search many times — FTS5 is fast because it's indexed
Use boolean operators — AND, OR, NOT for precision
Phrase search for exact terms — "exact match" with quotes
Always cite sources — Include Source: URLs in reports
Rebuild periodically — Re-index when documentation updates
Use JSON for analysis — Pipe to jq or other tools for processing
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: carev01
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T08:00:21.085Z
- Expires at: 2026-05-07T08:00:21.085Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/md-docs-search)
- [Send to Agent page](https://openagent3.xyz/skills/md-docs-search/agent)
- [JSON manifest](https://openagent3.xyz/skills/md-docs-search/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/md-docs-search/agent.md)
- [Download page](https://openagent3.xyz/downloads/md-docs-search)