Tech Distiller
yaofeino1/tech-distiller
Collects technical documents from URLs, files, wikis or APIs, filters them by role or technical direction, and writes a structured report on architecture, algorithms and design decisions.
Summarize a Yuque document or knowledge base at one-line, key-point, or detailed granularity.
Install Smart Summary
$ npx skills add yuque/yuque-ecosystem --skill smart-summary -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install yuque/yuque-ecosystem smart-summary --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/yuque/yuque-ecosystem.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/smart-summary .claude/skills/smart-summary && rm -rf skills-srcUse ~/.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/
Install the "smart-summary" agent skill from https://github.com/yuque/yuque-ecosystem/tree/main/skills/smart-summary into .claude/skills/smart-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "smart-summary", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/yuque/yuque-ecosystem/tree/main/skills/smart-summaryType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add yuque/yuque-ecosystem --skill smart-summary -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install yuque/yuque-ecosystem smart-summary --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yuque/yuque-ecosystem.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/smart-summary .agents/skills/smart-summary && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "smart-summary" agent skill from https://github.com/yuque/yuque-ecosystem/tree/main/skills/smart-summary into .agents/skills/smart-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "smart-summary", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add yuque/yuque-ecosystem --skill smart-summary -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install yuque/yuque-ecosystem smart-summary --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yuque/yuque-ecosystem.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/smart-summary .cursor/skills/smart-summary && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "smart-summary" agent skill from https://github.com/yuque/yuque-ecosystem/tree/main/skills/smart-summary into .cursor/skills/smart-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "smart-summary", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/yuque/yuque-ecosystem.git --path skills/smart-summary--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add yuque/yuque-ecosystem --skill smart-summary -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install yuque/yuque-ecosystem smart-summary --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yuque/yuque-ecosystem.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/smart-summary .gemini/skills/smart-summary && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "smart-summary" agent skill from https://github.com/yuque/yuque-ecosystem/tree/main/skills/smart-summary into .gemini/skills/smart-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "smart-summary", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install yuque/yuque-ecosystem smart-summaryInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add yuque/yuque-ecosystem --skill smart-summary -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/yuque/yuque-ecosystem.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/smart-summary .github/skills/smart-summary && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "smart-summary" agent skill from https://github.com/yuque/yuque-ecosystem/tree/main/skills/smart-summary into .github/skills/smart-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "smart-summary", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add yuque/yuque-ecosystem --skill smart-summary -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install yuque/yuque-ecosystem smart-summary --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yuque/yuque-ecosystem.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/smart-summary .opencode/skills/smart-summary && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "smart-summary" agent skill from https://github.com/yuque/yuque-ecosystem/tree/main/skills/smart-summary into .opencode/skills/smart-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "smart-summary", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
smart-summary- GitHub stars
- 228
- Token cost
- ~1.3k tokens
- SKILL.md length
- 508 words
- Files
- 1
- Skills in repo
- 8
- Repo updated
- First seen
- Licence
- MIT
At a glance
Summarize a Yuque document or knowledge base at one-line, key-point, or detailed granularity.
- Works in 4 steps: Identify the Target → Determine Summary Granularity → Fetch Content → …
- The user wants a quick overview of a document
- SKILL.md covers When to Use, Required MCP Tools, Workflow and Guidelines, plus 1 more section
- Reaches yuque.com
What it does
Smart Summary is an agent skill from yuque/yuque-ecosystem. Summarize a Yuque document or knowledge base at one-line, key-point, or detailed granularity. Use when the user wants a quick overview of a document or repo; trigger phrases include “帮我总结一下这篇文档”, “这个知识库讲了什么”, and “summarize this doc”.
Its SKILL.md is about 1.3k 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 bases and Summarization. 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 a quick overview of a document
- Trigger phrases include 帮我总结一下这篇文档
- Summarize this doc
Example prompts
- “帮我总结一下这篇文档”
- “这个知识库讲了什么”
- “summarize this doc”
- “/smart-summary”
Requirements
- Compatibility (from SKILL.md): Requires the yuque-mcp MCP server connected with a personal Yuque token
Workflow steps
4 steps, taken from the step headings in SKILL.md.
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
Hosts in commands or code, which the agent is likely to contact:
yuque.com
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
Smart Summary loads about 1.3k tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 508 words of instructions outside code blocks.
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). 508 words, ~1,294 tokens.
Download SKILL.mdSave it as
.claude/skills/smart-summary/SKILL.md (or your agent's skills folder).- name
- smart-summary
- description
- Summarize a Yuque document or knowledge base at one-line, key-point, or detailed granularity. Use when the user wants a quick overview of a document or repo; trigger phrases include “帮我总结一下这篇文档”, “这个知识库讲了什么”, and “summarize this doc”.
- compatibility
- Requires the yuque-mcp MCP server connected with a personal Yuque token
- license
- MIT
- metadata.author
- yuque
- metadata.version
- 1.0
Smart Summary — Yuque Document & Knowledge Base Summarization
Generate summaries at different granularity levels for any Yuque document or entire knowledge base. Supports one-liner, key points extraction, and detailed summary modes.
When to Use
- User wants a quick summary of a Yuque document or knowledge base
- User says "帮我总结一下这篇文档", "summarize this doc", "这个知识库讲了什么"
- User shares a Yuque document link and asks for a summary
- User wants to quickly understand the content of a repo without reading everything
Required MCP Tools
All tools are from the yuque-mcp server:
yuque_get_doc— Read full document content by slug/idyuque_get_book— Get knowledge base metadatayuque_list_docs— List all documents in a knowledge baseyuque_get_toc— Get the table of contents of a knowledge base
Workflow
Step 1: Identify the Target
Determine what the user wants summarized:
Case A — Single Document:
The user provides a document link or specifies a document by name. Extract repo_id (namespace) and doc_id (slug) from the link.
Yuque doc URL pattern: https://www.yuque.com/{namespace}/{slug}
Case B — Entire Knowledge Base:
The user provides a knowledge base link or name. Extract repo_id (namespace).
Yuque repo URL pattern: https://www.yuque.com/{namespace}
If the user's input is ambiguous, ask: "你想总结单篇文档还是整个知识库？"
Step 2: Determine Summary Granularity
Check if the user specified a granularity level. If not, default to key points.
| Level | Trigger Phrases | Output |
|---|---|---|
| one-liner (一句话摘要) | "一句话总结", "简单说说", "TL;DR" | 1 sentence, ≤50 words |
| key-points (要点提取) | "要点", "关键点", "summarize" (default) | 5-10 bullet points |
| detailed (详细摘要) | "详细总结", "完整摘要", "deep summary" | Structured multi-section summary |
Step 3: Fetch Content
For a single document:
Tool: yuque_get_doc
Parameters:
repo_id: "<namespace>"
doc_id: "<slug>"For an entire knowledge base:
First, get the TOC to understand the structure:
Tool: yuque_get_toc
Parameters:
repo_id: "<namespace>"Then list all documents:
Tool: yuque_list_docs
Parameters:
repo_id: "<namespace>"For knowledge base summaries, read up to 10 key documents (prioritize by TOC order and recent updates). Do NOT try to read every document in a large repo.
Tool: yuque_get_doc
Parameters:
repo_id: "<namespace>"
doc_id: "<slug>"If yuque_get_doc returns a 404, skip the document and note it may have been deleted.
If yuque_get_doc returns a 403, note the user may lack permission.
Show full SKILL.md (191 more words)Show less
Step 4: Generate Summary
One-liner format:
📝 **一句话摘要**：[一句话概括文档/知识库的核心内容]Key-points format:
## 📋 要点摘要
**文档**：[文档标题](文档链接)
**知识库**：[知识库名称]
**更新时间**：YYYY-MM-DD
### 核心要点
1. **[要点标题]**：[简要说明，1-2 句话]
2. **[要点标题]**：[简要说明，1-2 句话]
3. **[要点标题]**：[简要说明，1-2 句话]
...
### 一句话总结
[用一句话概括全文核心观点]Detailed format:
## 📖 详细摘要
**文档**：[文档标题](文档链接)
**知识库**：[知识库名称]
**更新时间**：YYYY-MM-DD
**字数**：约 X 字
### 背景与目的
[文档的背景、写作目的，2-3 句话]
### 主要内容
#### [章节 1 标题]
[该章节的核心内容摘要]
#### [章节 2 标题]
[该章节的核心内容摘要]
...
### 核心结论
- [结论 1]
- [结论 2]
- [结论 3]
### 一句话总结
[用一句话概括全文]For knowledge base summaries, use this format:
## 📚 知识库摘要
**知识库**：[知识库名称](知识库链接)
**文档数量**：X 篇
**最近更新**：YYYY-MM-DD
### 知识库概览
[2-3 句话描述这个知识库的主题和用途]
### 内容结构
1. **[分类/目录 1]**（X 篇）：[简要描述]
2. **[分类/目录 2]**（X 篇）：[简要描述]
...
### 重点文档
1. [文档标题](链接) — [一句话描述]
2. [文档标题](链接) — [一句话描述]
3. [文档标题](链接) — [一句话描述]Guidelines
- Always answer in the same language the user used (Chinese or English)
- For knowledge base summaries, focus on structure and key documents rather than trying to summarize every single doc
- Preserve the original document's terminology and key concepts
- If the document is very short (< 100 words), just present the content directly instead of summarizing
- Never fabricate content not present in the original document
- Include links back to the original document(s) so the user can read the full source
- When summarizing a knowledge base, respect the TOC order as it reflects the author's intended structure
Error Handling
| Situation | Action |
|---|---|
| Document not found (404) | Inform user the document may have been deleted or the link is incorrect |
| Permission denied (403) | Tell user they may lack permission to access this document |
| Knowledge base is empty | Inform user: "这个知识库目前没有文档" |
| Knowledge base has 50+ docs | Read only the top 10 by TOC order, note that summary covers key documents only |
| Document content is empty | Skip and note: "该文档内容为空" |
| API timeout | Retry once, then inform user of connectivity issue |
© 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/smart-summary of yuque/yuque-ecosystem.
Open the folder on GitHubat commit 2959228
Compare with similar skills
Smart Summary 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Smart Summary this skillyuque/yuque-ecosystem | 228 | — | ~1.3k | Automated safety check: Pass | MIT | |
| Tech Distilleryaofeino1/tech-distiller | 144 | — | ~1.2k | Automated safety check: Pass | None | |
| Capture Conversationoutline/outline | 41k | — | ~474 | Automated safety check: Pass | Custom licence | |
| Project CairniBlinkQ/project-cairn | 235 | 2 repos | ~861 | Automated safety check: Pass | MIT | |
| LLM Wiki Knowledge GraphEgonex-AI/Understand-Anything | 86k | 1 repos | ~1.5k | Automated safety check: Pass | MIT | |
| Find And Citeoutline/outline | 41k | — | ~537 | Automated safety check: Pass | Custom licence |
Similar skills
Capture Conversation
outline/outline
Save the current conversation, a decision, or a set of notes as a document in an Outline collection; use when the user wants to keep what was discussed in their knowledge base.
Project Cairn
iBlinkQ/project-cairn
Standardize how an AI-collaboration project turns work into reusable knowledge.
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.
Find And Cite
outline/outline
Answer questions from the Outline knowledge base with quotes and links to the source documents; use when the user asks what the team knows, documented, or decided about a topic.
Xhs Virtual Product
chenjin-cmd/xhs-virtual-product
This skill helps plan, select, produce, and market Xiaohongshu (RED) virtual/digital products — templates, knowledge bases, test tools, study materials.
More from yuque/yuque-ecosystem
All 8 skills in this repoDaily Capture
yuque/yuque-ecosystem
Capture fleeting ideas in Yuque and periodically organize them into structured thematic notes.
Knowledge Connect
yuque/yuque-ecosystem
Analyze Yuque documents to uncover related topics, complementary notes, and cross-reference opportunities.
Note Refine
yuque/yuque-ecosystem
Polish rough Yuque notes into structured, readable documents while preserving their meaning.
Reading Digest
yuque/yuque-ecosystem
Extract core insights, golden quotes, and action items from articles, then create structured Yuque reading notes.
Smart Search
yuque/yuque-ecosystem
Search personal Yuque knowledge bases with natural-language queries and synthesize answers with source links.
Stale Detector
yuque/yuque-ecosystem
Scan a Yuque knowledge base for stale or outdated documents and recommend updates or archiving.
Related
Categories
Questions about Smart Summary
What does Smart Summary do?
Summarize a Yuque document or knowledge base at one-line, key-point, or detailed granularity. Smart Summary is an agent skill from yuque/yuque-ecosystem. Summarize a Yuque document or knowledge base at one-line, key-point, or detailed granularity.
When should I use Smart Summary?
Smart Summary fits situations like: the user wants a quick overview of a document; trigger phrases include 帮我总结一下这篇文档; summarize this doc.
How do I install Smart Summary in Claude Code?
Run `npx skills add yuque/yuque-ecosystem --skill smart-summary -a claude-code`. Or copy the skill folder (skills/smart-summary in yuque/yuque-ecosystem) into .claude/skills/smart-summary in your project. Claude Code loads it when a task matches its description.
How do I install Smart Summary in Codex?
Run `npx skills add yuque/yuque-ecosystem --skill smart-summary -a codex`. Or copy the skill folder (skills/smart-summary in yuque/yuque-ecosystem) into .agents/skills/smart-summary in your project. Codex loads it when a task matches its description.
Can I use Smart Summary 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 smart-summary -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/smart-summary, .gemini/skills/smart-summary, .github/skills/smart-summary and .opencode/skills/smart-summary in your project.
What does Smart Summary need to run?
SKILL.md names no scripts, command-line tools or credentials: Smart Summary is instructions for the agent only. Compatibility (from SKILL.md): Requires the yuque-mcp MCP server connected with a personal Yuque token.
Does Smart Summary access the network?
SKILL.md names 1 domain. In commands or code: yuque.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.
Is Smart Summary 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 Smart Summary use?
Smart Summary 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 Smart Summary use?
About 1.3k tokens (SKILL.md is roughly 5.2k 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 Smart Summary?
Skills that share tags, products or a category with Smart Summary: Tech Distiller (yaofeino1/tech-distiller, 144 stars), Capture Conversation (outline/outline, 41k stars), Project Cairn (iBlinkQ/project-cairn, 235 stars) and LLM Wiki Knowledge Graph (Egonex-AI/Understand-Anything, 86k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Smart Summary?
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.