# Send Curated 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "curated-search", "name": "Curated Search", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/qsmtco/curated-search", "canonicalUrl": "https://clawhub.ai/qsmtco/curated-search", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/curated-search", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=curated-search", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "CHANGELOG.md", "CONTRIBUTING.md", "DOMAIN_GUIDE.md", "IMPLEMENTATION_SUMMARY_2026-02-12.md", "PLAN.md", "README.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/curated-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/curated-search", "downloadUrl": "https://openagent3.xyz/downloads/curated-search", "agentUrl": "https://openagent3.xyz/skills/curated-search/agent", "manifestUrl": "https://openagent3.xyz/skills/curated-search/agent.json", "briefUrl": "https://openagent3.xyz/skills/curated-search/agent.md" } } ``` ## Documentation ### Summary Domain-restricted full-text search over a curated whitelist of technical documentation (MDN, Python docs, etc.). Provides clean, authoritative results without web spam. ### External Endpoints This skill does not call any external network endpoints during search operations. The crawler optionally makes outbound HTTP requests during index builds (one‑time setup), but those are user‑initiated (npm run crawl) and respect the configured domain whitelist. ### Security & Privacy Search is fully local – After the index is built, all queries run offline; no data leaves your machine. Crawling is optional and whitelist‑scoped – The crawler only accesses domains you explicitly list in config.yaml. It respects robots.txt and configurable delays. No telemetry – No usage data is transmitted externally. Configuration is read from local config.yaml and the index file in data/. ### Model Invocation Note The curated-search.search tool is invoked only when the user explicitly calls it. It does not run autonomously. OpenClaw calls the tool handler (scripts/search.js) when the user asks to search the curated index. ### Trust Statement By using this skill, you trust that the code operates locally and only crawls domains you approve. The skill does not send your queries or workspace data to any third party. Review the open‑source implementation before installing. ### Tool: curated-search.search Search the curated index. ### Parameters NameTypeRequiredDefaultDescriptionquerystringyes—Search query termslimitnumberno5Maximum results (capped by config.max_limit, typically 100)domainstringnonullFilter to specific domain (e.g., docs.python.org)min_scorenumberno0.0Minimum relevance score (0.0–1.0); filters out low-quality matchesoffsetnumberno0Pagination offset (skip first N results) ### Response JSON array of result objects: [ { "title": "Python Tutorial", "url": "https://docs.python.org/3/tutorial/", "snippet": "Python is an easy to learn, powerful programming language...", "domain": "docs.python.org", "score": 0.87, "crawled_at": 1707712345678 } ] Fields: title — Document title (cleaned) url — Source URL (canonical) snippet — Excerpt (~200 chars) from content domain — Hostname of source score — BM25 relevance score (higher is better; not normalized 0–1 but typically 0–1 range) crawled_at — Unix timestamp when page was crawled ### Example Agent Calls search CuratedSearch for "python tutorial" search CuratedSearch for "async await" limit=3 domain=developer.mozilla.org search CuratedSearch for "linux man page" min_score=0.3 ### Errors If an error occurs, the tool exits non-zero and prints a JSON error object to stderr, e.g.: { "error": "index_not_found", "message": "Search index not found. The index has not been built yet.", "suggestion": "Run the crawler first: npm run crawl", "details": { "path": "data/index.json" } } Common error codes: CodeMeaningSuggested Fixconfig_missingConfiguration file not foundSpecify --config path or ensure config.yaml existsconfig_invalidYAML parsing failedCheck syntax in config.yamlconfig_missing_index_pathindex.path not setAdd index.path to configindex_not_foundIndex file missingRun npm run crawl to build indexindex_corruptedIndex file incompatible or corruptedRebuild index with npm run crawlindex_init_failedUnexpected index initialization errorCheck permissions, reinstall dependenciesmissing_queryNo query providedProvide --query argumentquery_too_longQuery exceeds 1000 charactersShorten the querylimit_exceededLimit > config.max_limitUse a smaller limitinvalid_domainDomain filter malformedUse format like docs.python.orgconflicting_flagsMutually exclusive flags used (e.g., --stats with --query)Use flags correctlystats_failedCould not retrieve index statsEnsure index is accessiblesearch_failedSearch execution threw an errorCheck query and index integrity ### Configuration Edit config.yaml in the skill directory. Key sections: domains — whitelist of allowed domains (required) seeds — starting URLs for crawling crawl — depth, delay, timeout, max_documents content — min_content_length, max_content_length index — path to index files search — default_limit, max_limit, min_score See README.md for full configuration docs. ### Support Full documentation: README.md Technical specs: specs/ Build plan: PLAN.md Contributor guide: CONTRIBUTING.md Issues: Report on GitHub (or via OpenClaw maintainers) ## Trust - Source: tencent - Verification: Indexed source record - Publisher: qsmtco - Version: 1.0.7 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/curated-search) - [Send to Agent page](https://openagent3.xyz/skills/curated-search/agent) - [JSON manifest](https://openagent3.xyz/skills/curated-search/agent.json) - [Markdown brief](https://openagent3.xyz/skills/curated-search/agent.md) - [Download page](https://openagent3.xyz/downloads/curated-search)