Agent skill

Knowledge Connect

by yuque in yuque/yuque-ecosystem

Analyze Yuque documents to uncover related topics, complementary notes, and cross-reference opportunities.

MITAuto-check passedKnowledge Management

Install Knowledge Connect

skills CLI
$ npx skills add yuque/yuque-ecosystem --skill knowledge-connect -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install yuque/yuque-ecosystem knowledge-connect --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/yuque/yuque-ecosystem.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/knowledge-connect .claude/skills/knowledge-connect && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
knowledge-connect
GitHub stars
228
Token cost
~1.5k tokens
SKILL.md length
565 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Analyze Yuque documents to uncover related topics, complementary notes, and cross-reference opportunities.

  • Works in 5 steps: Determine the Scope → Analyze Documents → Discover Connections → …
  • The user wants connections
  • SKILL.md covers When to Use, Required MCP Tools, Workflow and Guidelines, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Knowledge Connect is an agent skill from yuque/yuque-ecosystem. Analyze Yuque documents to uncover related topics, complementary notes, and cross-reference opportunities. Use when the user wants connections or a knowledge graph; trigger phrases include “帮我找找文档之间的关联”, “哪些笔记是相关的”, “这篇文档和哪些笔记有关”, “connect my notes”, and “find related documents”.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires the yuque-mcp MCP server connected with a personal Yuque token

It sits in Knowledge Management, covering Knowledge graphs. The repository describes itself as: Yuque AI Ecosystem — MCP Server, Skills & Plugin for Yuque (语雀). The licence is MIT.

When your agent uses it

  • The user wants connections
  • A knowledge graph
  • Trigger phrases include 帮我找找文档之间的关联
  • Connect my notes

Example prompts

  • “帮我找找文档之间的关联”
  • “哪些笔记是相关的”
  • “这篇文档和哪些笔记有关”
  • “/knowledge-connect”

Requirements

  • Compatibility (from SKILL.md): Requires the yuque-mcp MCP server connected with a personal Yuque token

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Determine the Scope
  2. Analyze Documents
  3. Discover Connections
  4. Present Connection Map
  5. Add Cross-References (Optional)

What it can do on your machine

Read from SKILL.md and the folder at commit 2959228. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires the yuque-mcp MCP server connected with a personal Yuque token

    From compatibility in the SKILL.md frontmatter.

Context cost

Knowledge Connect loads about 1.5k tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 565 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from yuque/yuque-ecosystem at commit 2959228, republished under its MIT licence (© yuque). 565 words, ~1,499 tokens.

Download SKILL.mdSave it as .claude/skills/knowledge-connect/SKILL.md (or your agent's skills folder).
name
knowledge-connect
description
Analyze Yuque documents to uncover related topics, complementary notes, and cross-reference opportunities. Use when the user wants connections or a knowledge graph; trigger phrases include “帮我找找文档之间的关联”, “哪些笔记是相关的”, “这篇文档和哪些笔记有关”, “connect my notes”, and “find related documents”.
compatibility
Requires the yuque-mcp MCP server connected with a personal Yuque token
license
MIT
metadata.author
yuque
metadata.version
1.0

Analyze documents in your Yuque knowledge base, find hidden connections between them — similar topics, complementary content, shared concepts — and suggest cross-reference links to help you build a connected knowledge network.

When to Use

  • User wants to find connections between their notes
  • User says "帮我找找文档之间的关联", "哪些笔记是相关的", "connect my notes"
  • User just finished writing a document and wants to link it to related ones
  • User says "这篇文档和哪些笔记有关", "find related documents"
  • User wants to build a knowledge graph from their existing notes

Required MCP Tools

All tools are from the yuque-mcp server:

  • yuque_list_books — List user's knowledge bases
  • yuque_list_docs — List all documents in a knowledge base
  • yuque_get_doc — Read document content for analysis
  • yuque_search — Search for potentially related documents
  • yuque_update_doc — Add cross-reference links to documents

Workflow

Step 1: Determine the Scope

Ask the user what to analyze:

Case A — Single document: User provides a specific document link. Find connections for this one document.

Case B — Entire knowledge base: User specifies a knowledge base. Analyze all documents within it.

Case C — Across knowledge bases: User wants cross-repo connections. Analyze documents across multiple repos.

For Case B/C, first list available repos:

Tool: yuque_list_books

Then list documents in the target repo(s):

Tool: yuque_list_docs
Parameters:
  repo_id: "<namespace>"
Step 2: Analyze Documents

For each document in scope, fetch its content:

Tool: yuque_get_doc
Parameters:
  repo_id: "<namespace>"
  doc_id: "<slug>"

Extract the following from each document:

ElementDescription
TopicsMain subjects the document covers
Key ConceptsImportant terms, frameworks, or ideas
QuestionsQuestions raised but not fully answered
ReferencesExternal sources or concepts mentioned
DomainThe knowledge area (tech, management, personal, etc.)
Step 3: Discover Connections

Compare documents pairwise and identify these types of connections:

Connection TypeDescriptionExample
🔄 Same TopicDocuments covering the same subject from different anglesTwo articles about "distributed systems"
🧩 ComplementaryOne document answers questions raised in anotherA "why microservices" doc + a "microservices pitfalls" doc
📚 SequentialDocuments that form a natural reading sequence"Intro to X" → "Advanced X" → "X in Practice"
🌱 EvolutionEarlier and later thinking on the same topicA draft idea → a refined version months later
🔗 Shared ConceptDocuments that reference the same key conceptMultiple docs mentioning "second brain" methodology

For single-document analysis, also search for related documents:

Tool: yuque_search
Parameters:
  query: "[key topics from the document]"
  type: "doc"
Show full SKILL.md (209 more words)Show less
Step 4: Present Connection Map

Present the discovered connections to the user:

markdown
## 🕸️ 知识关联分析

分析范围:[知识库名称] — [N] 篇文档
发现 [X] 组关联

### 关联 1:[主题/概念名称]

| 文档 | 关联类型 | 关联强度 |
|------|----------|----------|
| [文档 A 标题](链接) | 🔄 同主题 | ⭐⭐⭐ |
| [文档 B 标题](链接) | 🧩 互补 | ⭐⭐⭐ |
| [文档 C 标题](链接) | 🔗 共享概念 | ⭐⭐ |

**关联说明**:[为什么这些文档相关,它们之间的具体联系是什么]

**建议**:[具体的交叉引用建议,如 "在文档 A 的第二节末尾添加指向文档 B 的链接"]

### 关联 2:[主题/概念名称]

...

### 🏝️ 孤岛文档

以下文档暂未发现明显关联:
- [文档标题](链接) — 可能需要补充更多内容后再分析

### 💡 建议

1. [建议 1:如 "建议创建一篇索引文档,串联关于 X 主题的 5 篇笔记"]
2. [建议 2:如 "文档 A 和文档 B 观点互补,可以合并成一篇完整的指南"]
Step 5: Add Cross-References (Optional)

Ask the user: "要自动在相关文档中添加交叉引用链接吗?"

If confirmed, for each document that needs cross-references:

Tool: yuque_get_doc
Parameters:
  repo_id: "<namespace>"
  doc_id: "<slug>"

Append a "Related Notes" section at the end:

markdown

---

## 📎 相关笔记

- 🔄 [相关文档标题](链接) — [一句话说明关联]
- 🧩 [相关文档标题](链接) — [一句话说明关联]

*由 AI 分析生成的关联推荐 — YYYY-MM-DD*
Tool: yuque_update_doc
Parameters:
  repo_id: "<namespace>"
  doc_id: "<slug>"
  body: "<original content + related notes section>"

Confirm: "已为 [N] 篇文档添加了交叉引用链接 ✅"

Guidelines

  • Always answer in the same language the user used (Chinese or English)
  • Connection strength should be based on actual content overlap, not just title similarity
  • Be specific about why documents are connected — vague "they're related" is not helpful
  • Don't force connections — if two documents aren't meaningfully related, don't link them
  • For large knowledge bases (> 50 docs), suggest analyzing in batches by topic area
  • The "孤岛文档" section is valuable — it helps users identify notes that need more context
  • When adding cross-references, never modify the original content — only append at the end
  • Suggest creating index/hub documents for topics with 3+ related notes

Error Handling

SituationAction
Document not found (404)Skip the document and note it in the report
Permission denied (403)Tell user they may lack permission to access this document
Knowledge base is emptyInform user: "该知识库还没有文档,先写几篇笔记再来分析关联吧"
Knowledge base has < 3 documentsInform user: "文档数量较少,建议积累更多笔记后再做关联分析,效果会更好"
yuque_update_doc failsPresent the suggested cross-references in chat for manual adding
Too many documents to analyze at onceSuggest narrowing scope: "知识库文档较多,建议先选一个主题方向分析"

© yuque, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/knowledge-connect of yuque/yuque-ecosystem.

Open the folder on GitHubat commit 2959228

Compare with similar skills

Knowledge Connect next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Knowledge Connect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Knowledge Connect this skillyuque/yuque-ecosystem228—~1.5kAutomated safety check: PassMIT
LLM Wiki Knowledge GraphEgonex-AI/Understand-Anything86k1 repos~1.5kAutomated safety check: PassMIT
Ontology1mancompany/OneManCompany4402 repos~1.5kAutomated safety check: PassApache-2.0
Graphagenticnotetaking/arscontexta3.5k1 repos~4.9kAutomated safety check: NotesMIT
Obsidian Canvas BoardsAgriciDaniel/claude-obsidian15k—~1.4kAutomated safety check: PassMIT
Knowledge Graphgnomeria/usbtree690—~1.5kAutomated safety check: PassMIT

Similar skills

  • LLM Wiki Knowledge Graph

    Egonex-AI/Understand-Anything

    Detects a Karpathy-pattern LLM wiki and builds an interactive knowledge graph with entities, implicit relationships and topic clusters.

    86k GitHub starsUsed in 1 repo~1.5k tokens
    Knowledge ManagementAuto-check passed
  • Ontology

    1mancompany/OneManCompany

    Typed knowledge graph for structured agent memory and composable skills.

    440 GitHub starsUsed in 2 repos~1.5k tokens
    Knowledge ManagementAuto-check passed
  • Graph

    agenticnotetaking/arscontexta

    Interactive knowledge graph analysis. An agent skill from agenticnotetaking/arscontexta.

    3.5k GitHub starsUsed in 1 repo~4.9k tokens
    Knowledge ManagementAuto-check: notes
  • Obsidian Canvas Boards

    AgriciDaniel/claude-obsidian

    Creates, inspects and updates Obsidian JSON Canvas boards in a vault, with text, file, link, group and edge nodes, using safe recoverable edits.

    15k GitHub stars~1.4k tokensUpdated 27 days ago
    Knowledge ManagementAuto-check passed
  • Knowledge Graph

    gnomeria/usbtree

    Set up and maintain a lightweight, file-based knowledge graph of the repo — entities, typed relations, decisions, gotchas — so agents load context fast instead of re-exploring the codebase every…

    690 GitHub stars~1.5k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed
  • Stats

    agenticnotetaking/arscontexta

    Show vault statistics and knowledge graph metrics. An agent skill from agenticnotetaking/arscontexta.

    3.5k GitHub starsUsed in 1 repo~3.1k tokens
    Knowledge ManagementAuto-check: notes

More from yuque/yuque-ecosystem

All 8 skills in this repo
  • Daily Capture

    yuque/yuque-ecosystem

    Capture fleeting ideas in Yuque and periodically organize them into structured thematic notes.

    228 GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Note Refine

    yuque/yuque-ecosystem

    Polish rough Yuque notes into structured, readable documents while preserving their meaning.

    228 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Reading Digest

    yuque/yuque-ecosystem

    Extract core insights, golden quotes, and action items from articles, then create structured Yuque reading notes.

    228 GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Smart Search

    yuque/yuque-ecosystem

    Search personal Yuque knowledge bases with natural-language queries and synthesize answers with source links.

    228 GitHub stars~993 tokensUpdated 2 mo ago
    Auto-check passed
  • Smart Summary

    yuque/yuque-ecosystem

    Summarize a Yuque document or knowledge base at one-line, key-point, or detailed granularity.

    228 GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Stale Detector

    yuque/yuque-ecosystem

    Scan a Yuque knowledge base for stale or outdated documents and recommend updates or archiving.

    228 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Knowledge Connect

What does Knowledge Connect do?

Analyze Yuque documents to uncover related topics, complementary notes, and cross-reference opportunities. Knowledge Connect is an agent skill from yuque/yuque-ecosystem. Analyze Yuque documents to uncover related topics, complementary notes, and cross-reference opportunities.

When should I use Knowledge Connect?

Knowledge Connect fits situations like: the user wants connections; A knowledge graph; trigger phrases include 帮我找找文档之间的关联; connect my notes.

How do I install Knowledge Connect in Claude Code?

Run `npx skills add yuque/yuque-ecosystem --skill knowledge-connect -a claude-code`. Or copy the skill folder (skills/knowledge-connect in yuque/yuque-ecosystem) into .claude/skills/knowledge-connect in your project. Claude Code loads it when a task matches its description.

How do I install Knowledge Connect in Codex?

Run `npx skills add yuque/yuque-ecosystem --skill knowledge-connect -a codex`. Or copy the skill folder (skills/knowledge-connect in yuque/yuque-ecosystem) into .agents/skills/knowledge-connect in your project. Codex loads it when a task matches its description.

Can I use Knowledge Connect in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yuque/yuque-ecosystem --skill knowledge-connect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/knowledge-connect, .gemini/skills/knowledge-connect, .github/skills/knowledge-connect and .opencode/skills/knowledge-connect in your project.

What does Knowledge Connect need to run?

SKILL.md names no scripts, command-line tools or credentials: Knowledge Connect is instructions for the agent only. Compatibility (from SKILL.md): Requires the yuque-mcp MCP server connected with a personal Yuque token.

Does Knowledge Connect access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Knowledge Connect safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Knowledge Connect use?

Knowledge Connect is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Knowledge Connect use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Knowledge Connect?

Skills that share tags, products or a category with Knowledge Connect: LLM Wiki Knowledge Graph (Egonex-AI/Understand-Anything, 86k stars), Ontology (1mancompany/OneManCompany, 440 stars), Graph (agenticnotetaking/arscontexta, 3.5k stars) and Obsidian Canvas Boards (AgriciDaniel/claude-obsidian, 15k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Knowledge Connect?

yuque (a GitHub organization) maintains it in yuque/yuque-ecosystem, which has 228 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on July 15, 2026.

Source: yuque/yuque-ecosystem on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.