knowledge-base

A tool for searching and reading documents stored in a configured knowledge base. It can find relevant passages, open documents, locate terms, and show the knowledge base’s mind map.

In plain words
What is it for?
Searching project materials, checking facts against source documents, finding specific sections, browsing files, and understanding how the knowledge base is organized.
Why use it?
It helps answer questions from internal or uploaded documents instead of relying on memory or unsupported guesses.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/xerrors/yuxi/knowledge-base
Any agent
npx skills add xerrors/Yuxi --skill knowledge-base
Clone the repo
git clone --depth 1 https://github.com/xerrors/Yuxi

Made for: Claude Code, Codex.

Per session 54 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 658 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00054 $0.00658
Opus 5 $0.00027 $0.00329
Sonnet 5 $0.00011 $0.00132
Haiku 4.5 $0.00005 $0.00066

Measured yesterday against content hash 0823987574e2, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

knowledge-base scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

backend/package/yuxi/agents/skills/buildin/knowledge-base/SKILL.md · 35 lines

What it actually says

知识库技能

当用户要求基于项目知识库、内部资料、上传入库文档或知识图谱相关内容回答问题时,使用此技能。

可用工具

  • list_kbs:列出当前会话可访问且已启用的知识库。
  • query_kb:按 kb_id 在指定知识库中检索内容,返回 file_id 和相关片段。
  • open_kb_document:按 kb_idfile_id 打开文档原文窗口,适合查看更完整上下文。
  • find_kb_document:在已知文档内用关键词或正则定位段落。
  • get_mindmap:查看知识库思维导图结构。
  • search_file:按文件名关键词搜索知识库中的文件,支持指定知识库或跨知识库,返回文件列表与分页信息。
  • download_kb_file:按 kb_idfile_id 下载知识库原始二进制(pdf/docx/xlsx 等)到沙盒 outputs 目录,返回沙盒内可见的 virtual_path。当后续需要用代码读取原始文件结构(如 openpyxl 读 xlsx 单元格、pdfplumber 重新解析版面)时使用;query_kb/open_kb_document 只返回文本切片,无法满足需要文件对象的场景。

操作流程

  1. 需要先确认当前会话有哪些知识库可用;不确定时调用 list_kbs
  2. 针对用户问题选择最相关的知识库,使用 query_kb 检索。
  3. 如果检索片段不足以回答,使用返回的 file_id 调用 open_kb_document 查看上下文。
  4. 如果用户要求定位术语、指标、章节或原文证据,使用 find_kb_document 在候选文档内查找。
  5. 当用户关心知识库结构、文件分类或知识框架时,使用 get_mindmap

关键约束

  • 只能访问当前会话配置和用户权限允许的知识库。
  • 不要编造 kb_idfile_id;优先从 list_kbsquery_kb 的返回结果中获取。
  • 回答需要可追溯时,应说明依据来自哪个知识库、文件或检索片段。
  • Dify 等外部只读知识库可能只支持检索,不一定支持打开全文或文档内查找;遇到工具返回限制说明时,应如实告知用户。
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 35 lines · 54 tokens per session scan A 0823987574e2

Subscribe to this mod's changes

knowledge-base is a skill published in the GitHub repository xerrors/Yuxi (6,591 stars, last pushed yesterday), licensed MIT. It adds 54 tokens to every session and 658 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

background-task

Add or modify work that runs outside the request/response cycle — emails, document ingestion, webhooks, cleanups, scheduled jobs. Use when something is slow or fire-and-forget, or when adding a periodic/cron task. This project's queue is {{ cookiecutter.backgroundtasks }}.

vstorm-co/full-stack-ai-agent-template · 62 tokens

agent-tool

Add a new tool/function the AI agent can call (e.g. look something up, hit an external API, perform an action). Use when extending the assistant's capabilities, wiring a new function into the agent, or when the model needs a new action. This project uses {{ cookiecutter.aiframework }}.

vstorm-co/full-stack-ai-agent-template · 66 tokens

frontend-feature

Build a new page, view, or data-driven feature in the Next.js frontend. Use when adding a route under the dashboard/marketing area, wiring UI to a backend endpoint, adding client state, or creating a localized page. Covers App Router, data fetching, Zustand stores, and i18n.

vstorm-co/full-stack-ai-agent-template · 64 tokens

rag-knowledge

Work with the RAG knowledge base — ingest documents, run semantic search, manage collections, or add a sync source/connector (Google Drive, S3). Use when populating or debugging the knowledge base, tuning retrieval, or adding a new document source. This project uses {{ cookiecutter.vectorstore }} + {{…

vstorm-co/full-stack-ai-agent-template · 76 tokens

alembic-migration

Create, review, and apply database schema changes with Alembic. Use whenever a SQLAlchemy model is added or changed, a column/index/constraint needs to change, or a data backfill is required — anything that alters the PostgreSQL schema.

vstorm-co/full-stack-ai-agent-template · 56 tokens

channel-bot

Work with messaging-channel bots (Telegram / Slack) — register a bot, route inbound messages through the AI agent, handle webhooks vs polling, or add a new channel adapter. Use when wiring chat into a messaging platform or debugging bot delivery.

vstorm-co/full-stack-ai-agent-template · 53 tokens