smart-search

Search personal Yuque knowledge bases and synthesize answers with source references.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/sliec/shared-files --skill smart-search-sliec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smart-search
Source: https://github.com/sliec/shared-files/tree/main/skills/smart-search
Command: npx skills add https://github.com/sliec/shared-files --skill smart-search-sliec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding information scattered across your personal Yuque knowledge bases requires manual browsing and reading. This Skill turns natural-language questions into targeted Yuque searches, reads the relevant documents, and returns a synthesized answer with source links. ## Core Features & Use Cases - Natural-Language Search: Extracts 1-3 concise keywords from your question and queries Yuque docs via the yuque-mcp server. - Document Reading & Ranking: Fetches full content of the top 3-5 most relevant documents, preferring recent updates. - Synthesized Answers with Citations: Produces a structured answer with key points, quotes, and reference links including repository name and update date. - Use Case: Ask "我的部署流程文档在哪?" and get a direct answer quoting your deployment doc, plus links to the source pages. ## Quick Start Ask the assistant to search your Yuque knowledge base for a topic, for example: search my Yuque docs for anything about error logging and summarize what you find.

Frequently Asked Questions about smart-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search my Yuque knowledge base with natural language?

Ask a question in plain language and the skill extracts 1-3 concise keywords, calls yuque_search via the yuque-mcp server, reads the top matching documents, and returns a synthesized answer with source links.

What MCP tools are required for Yuque document search?

The skill requires the yuque-mcp server providing two tools: yuque_search for keyword-based document search and yuque_get_doc for reading full document content by repo namespace and slug.

Does Yuque search work with English queries?

Yes, but Yuque search works best with short, specific Chinese keywords. The skill converts English questions into concise Chinese terms like 错误日志 before querying, and answers in the language you used.

Why does Yuque search return no results for my query?

Empty results usually mean the keywords are too specific or compound. The skill retries with synonyms, broader terms, or split terms; if still empty, it tells you honestly that no matching document was found.

What happens when a Yuque document returns a 403 or 404 error?

A 404 means the document may have been deleted, so the skill skips it and notes the issue. A 403 means your token lacks permission for that document, and the skill informs you of the access restriction.