skills/docs-search/SKILL.md
Search and query the Grounded Docs MCP Server documentation index. Covers listing indexed libraries, searching documentation content, and resolving library versions. Use when you need to look up API references, find code examples, or check which documentation is available in the local index.
npx skillsauth add arabold/docs-mcp-server docs-searchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Search the local Grounded Docs index for library documentation. These commands return structured data (JSON by default in non-interactive sessions) and never modify the index.
Always run list first if you are unsure whether a library has been indexed.
If nothing is indexed yet, use the docs-manage skill to scrape documentation
before searching.
List every indexed library and its available versions.
npx @arabold/docs-mcp-server@latest list [--output yaml]
| Flag | Description |
|------|-------------|
| --output json\|yaml\|toon | Structured output format (default: JSON in non-interactive) |
| --server-url <url> | Connect to a remote pipeline worker instead of the local store |
| --quiet | Suppress non-error diagnostics |
| --verbose | Enable debug logging |
Example output (YAML):
- library: react
versions:
- "19.0.0"
- "18.3.1"
- library: typescript
versions:
- "5.7.0"
Search documents in an indexed library by natural-language query.
npx @arabold/docs-mcp-server@latest search <library> "<query>" [options]
| Flag | Alias | Default | Description |
|------|-------|---------|-------------|
| --version <ver> | -v | latest | Version constraint (exact or range, e.g. 18.x, 5.2.x) |
| --limit <n> | -l | 5 | Maximum number of results |
| --exact-match | -e | false | Only match the exact version, no fallback |
| --embedding-model <model> | | | Embedding model (e.g. openai:text-embedding-3-small) |
| --server-url <url> | | | Remote pipeline worker URL |
| --output json\|yaml\|toon | | JSON | Structured output format |
| --quiet | | | Suppress non-error diagnostics |
| --verbose | | | Enable debug logging |
Example:
npx @arabold/docs-mcp-server@latest search react "useEffect cleanup" --version 18.x --limit 3 --output yaml
Each result contains a content snippet, source URL, and relevance score.
Resolve the best matching documentation version for a library.
npx @arabold/docs-mcp-server@latest find-version <library> [--version <pattern>]
| Flag | Alias | Description |
|------|-------|-------------|
| --version <pattern> | -v | Version pattern to match (supports ranges) |
| --server-url <url> | | Remote pipeline worker URL |
| --output json\|yaml\|toon | | Structured output format |
| --quiet | | Suppress non-error diagnostics |
| --verbose | | Enable debug logging |
Example:
npx @arabold/docs-mcp-server@latest find-version react --version "18.x" --output yaml
Returns the resolved version string and library metadata.
All three commands emit structured data to stdout. Diagnostics and progress
messages go to stderr and are suppressed by default in non-interactive
sessions. Use --verbose (or set LOG_LEVEL=INFO) to re-enable them.
Use --quiet to suppress all non-error diagnostics regardless of session type.
To capture results programmatically, parse stdout as JSON (the default) or
request --output yaml for a more readable format.
# 1. Check what is indexed
npx @arabold/docs-mcp-server@latest list --output yaml
# 2. Search for relevant docs
npx @arabold/docs-mcp-server@latest search react "server components" --version 19.x --output yaml
# 3. If no results, index the docs first (see docs-manage skill), then retry
development
Fetch a single URL and convert its content to Markdown. Use when you need to read a web page, documentation page, or API reference without indexing it. The content is returned as plain Markdown text on stdout.
tools
Manage the Grounded Docs MCP Server documentation index. Covers scraping and indexing documentation from URLs or local files, refreshing existing indexes with changed content, and removing libraries from the index. Use when you need to add, update, or delete indexed documentation.
tools
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------