Agent skill

Reading Digest

by yuque in yuque/yuque-ecosystem

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

MITAuto-check passedKnowledge Management

Install Reading Digest

skills CLI
$ npx skills add yuque/yuque-ecosystem --skill reading-digest -a claude-code

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

GitHub CLI
$ gh skill install yuque/yuque-ecosystem reading-digest --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/reading-digest .claude/skills/reading-digest && 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
reading-digest
GitHub stars
228
Token cost
~1.3k tokens
SKILL.md length
544 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 4 steps: Get the Source Article → Analyze and Extract → Generate Structured Reading Notes → …
  • The user wants key takeaways
  • 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

Reading Digest is an agent skill from yuque/yuque-ecosystem. Extract core insights, golden quotes, and action items from articles, then create structured Yuque reading notes. Use when the user wants key takeaways or a personal reading-notes base; trigger phrases include “帮我做阅读笔记”, “读书笔记”, and “extract key points from this article”.

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 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 key takeaways
  • A personal reading-notes base
  • Trigger phrases include 帮我做阅读笔记
  • Extract key points from this article

Example prompts

  • “帮我做阅读笔记”
  • “extract key points from this article”
  • “/reading-digest”

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.

  1. Get the Source Article
  2. Analyze and Extract
  3. Generate Structured Reading Notes
  4. Save to Knowledge Base (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

Reading Digest loads about 1.3k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 544 words of instructions outside code blocks.

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

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). 544 words, ~1,264 tokens.

Download SKILL.mdSave it as .claude/skills/reading-digest/SKILL.md (or your agent's skills folder).
name
reading-digest
description
Extract core insights, golden quotes, and action items from articles, then create structured Yuque reading notes. Use when the user wants key takeaways or a personal reading-notes base; trigger phrases include “帮我做阅读笔记”, “读书笔记”, and “extract key points from this article”.
compatibility
Requires the yuque-mcp MCP server connected with a personal Yuque token
license
MIT
metadata.author
yuque
metadata.version
1.0

Reading Digest — Structured Reading Notes Generator

Read an article or document, extract core insights, golden quotes, and action items, then generate structured reading notes and optionally save them to a Yuque knowledge base.

When to Use

  • User has finished reading an article and wants to capture key takeaways
  • User says "帮我做阅读笔记", "extract key points from this article", "读书笔记"
  • User shares a Yuque document link and wants structured notes
  • User wants to build a personal reading notes knowledge base

Required MCP Tools

All tools are from the yuque-mcp server:

  • yuque_get_doc — Read full document content
  • yuque_list_books — List user's knowledge bases (to find the target repo for saving)
  • yuque_create_doc — Create a new document (to save reading notes)
  • yuque_search — Search for existing reading notes to avoid duplicates

Workflow

Step 1: Get the Source Article

Case A — Yuque document link: Extract repo_id and doc_id from the URL and fetch the content:

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

Case B — User pastes article text directly: Use the provided text as the source content. No tool call needed.

Case C — User provides an external URL: Inform the user: "我目前只能处理语雀文档链接或直接粘贴的文本。如果是外部文章,请把内容粘贴给我。"

If the document is not found (404) or permission denied (403), inform the user and stop.

Step 2: Analyze and Extract

Read through the full content and extract the following elements:

  1. Core Insights (核心观点) — The main arguments or ideas the author presents (3-7 items)
  2. Golden Quotes (金句) — Memorable, well-crafted sentences worth saving (2-5 items)
  3. Action Items (行动项) — Concrete things the reader can do based on this article (0-5 items)
  4. Key Concepts (关键概念) — Important terms or frameworks introduced (0-5 items)
  5. Personal Relevance (个人关联) — How this might connect to the reader's existing knowledge
Step 3: Generate Structured Reading Notes

Format the reading notes as follows:

markdown
# 📖 阅读笔记:[原文标题]

> **来源**:[文档标题](文档链接)
> **作者**:[原文作者]
> **阅读日期**:YYYY-MM-DD
> **阅读耗时**:约 X 分钟(按 300 字/分钟估算)

## 一句话总结

[用一句话概括这篇文章的核心价值]

## 核心观点

1. **[观点标题]**:[展开说明,2-3 句话]
2. **[观点标题]**:[展开说明,2-3 句话]
3. **[观点标题]**:[展开说明,2-3 句话]

## 金句摘录

> [原文金句 1]

> [原文金句 2]

> [原文金句 3]

## 关键概念

| 概念 | 解释 |
|------|------|
| [概念 1] | [简要解释] |
| [概念 2] | [简要解释] |

## 行动项

- [ ] [具体可执行的行动 1]
- [ ] [具体可执行的行动 2]
- [ ] [具体可执行的行动 3]

## 我的思考

[基于文章内容,提出 1-2 个延伸思考问题,帮助读者深入反思]

---
*由 AI 辅助生成的阅读笔记*

If the article has no clear action items, omit that section. If there are no notable golden quotes, omit that section too. Adapt the template to fit the content.

Show full SKILL.md (231 more words)Show less
Step 4: Save to Knowledge Base (Optional)

Ask the user: "要把这份阅读笔记保存到语雀知识库吗?如果要,请告诉我保存到哪个知识库。"

If the user specifies a knowledge base:

First, check if a reading notes document for this article already exists:

Tool: yuque_search
Parameters:
  query: "[原文标题] 阅读笔记"
  type: "doc"

If a duplicate is found, ask the user: "已经存在一份关于这篇文章的阅读笔记,要覆盖还是创建新的?"

Then create the document:

Tool: yuque_create_doc
Parameters:
  repo_id: "<target namespace>"
  title: "📖 阅读笔记:[原文标题]"
  body: "<generated reading notes in markdown>"

After saving, confirm: "阅读笔记已保存到「[知识库名称]」:[新文档链接]"

If the user doesn't want to save, just present the reading notes in the chat.

Guidelines

  • Always answer in the same language the user used (Chinese or English)
  • Golden quotes must be exact quotes from the original text — never paraphrase them
  • Action items should be specific and actionable, not vague ("学习 React hooks" not "多学习")
  • Core insights should capture the author's intent, not your interpretation
  • Estimate reading time based on ~300 Chinese characters/minute or ~200 English words/minute
  • If the article is very short (< 200 words), simplify the output — skip sections that don't apply
  • The "我的思考" section should pose genuine questions, not rhetorical ones

Error Handling

SituationAction
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
Document content is emptyInform user: "该文档内容为空,无法生成阅读笔记"
Target repo not found when savingList user's repos with yuque_list_books and ask them to pick one
yuque_create_doc failsInform user the save failed, present the notes in chat instead
Article is not text-based (e.g., pure images)Inform user: "该文档主要是图片内容,无法提取文字进行分析"

© 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/reading-digest of yuque/yuque-ecosystem.

Open the folder on GitHubat commit 2959228

Compare with similar skills

Reading Digest 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.

Reading Digest compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reading Digest this skillyuque/yuque-ecosystem228—~1.3kAutomated safety check: PassMIT
Video Lenskar2phi/video-lens113—~8.2kAutomated safety check: NotesMIT
Bulletmindsickn33/agentic-awesome-skills47k1 repos~916Automated safety check: PassMIT
YouTube Transcripts and SearchZeroPointRepo/youtube-skills1k1 repos~3.1kAutomated safety check: PassMIT
Youtube Transcript Extractor API Skillbrowser-act/skills6.1k1 repos~1.2kAutomated safety check: PassMIT
YouTube Transcript FetcherZeroPointRepo/youtube-skills1k1 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Video Lens

    kar2phi/video-lens

    Fetch a YouTube transcript and generate an executive summary, key points, and timestamped topic list as a polished HTML report.

    113 GitHub stars~8.2k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check: notes
  • Bulletmind

    sickn33/agentic-awesome-skills

    Convert input into clean, structured, hierarchical bullet points for summarization, note-taking, and structured thinking.

    47k GitHub starsUsed in 1 repo~916 tokens
    Knowledge ManagementAuto-check passed
  • YouTube Transcripts and Search

    ZeroPointRepo/youtube-skills

    Fetches YouTube transcripts and searches videos, channels and playlists through the TranscriptAPI.com service.

    1k GitHub starsUsed in 1 repo~3.1k tokens
    Knowledge ManagementAuto-check passed
  • This skill helps users automatically extract YouTube video transcripts and metadata via the BrowserAct API.

    6.1k GitHub starsUsed in 1 repo~1.2k tokens
    Knowledge ManagementAuto-check passed
  • YouTube Transcript Fetcher

    ZeroPointRepo/youtube-skills

    Fetches the transcript of a YouTube video through TranscriptAPI.com so the agent can summarize, quote, translate or fact-check what was said.

    1k GitHub starsUsed in 1 repo~1.1k tokens
    Knowledge ManagementAuto-check passed
  • YouTube Video Transcript

    ZeroPointRepo/youtube-skills

    Fetches YouTube transcripts through TranscriptAPI.com so an agent can summarize, quote or translate a video from a link or ID.

    1k GitHub starsUsed in 1 repo~1.1k tokens
    Knowledge ManagementAuto-check passed

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
  • Knowledge Connect

    yuque/yuque-ecosystem

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

    228 GitHub stars~1.5k 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
  • 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 Reading Digest

What does Reading Digest do?

Extract core insights, golden quotes, and action items from articles, then create structured Yuque reading notes. Reading Digest is an agent skill from yuque/yuque-ecosystem. Extract core insights, golden quotes, and action items from articles, then create structured Yuque reading notes.

When should I use Reading Digest?

Reading Digest fits situations like: the user wants key takeaways; A personal reading-notes base; trigger phrases include 帮我做阅读笔记; extract key points from this article.

How do I install Reading Digest in Claude Code?

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

How do I install Reading Digest in Codex?

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

Can I use Reading Digest 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 reading-digest -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reading-digest, .gemini/skills/reading-digest, .github/skills/reading-digest and .opencode/skills/reading-digest in your project.

What does Reading Digest need to run?

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

Does Reading Digest 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 Reading Digest 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 Reading Digest use?

Reading Digest 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 Reading Digest use?

About 1.3k tokens (SKILL.md is roughly 5.1k 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 Reading Digest?

Skills that share tags, products or a category with Reading Digest: Video Lens (kar2phi/video-lens, 113 stars), Bulletmind (sickn33/agentic-awesome-skills, 47k stars), YouTube Transcripts and Search (ZeroPointRepo/youtube-skills, 1k stars) and Youtube Transcript Extractor API Skill (browser-act/skills, 6.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reading Digest?

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.