Markdown Article Formatter
JimLiu/baoyu-skills
Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.
Generate a source-backed, shareable Chinese Markdown reading note from a Douban book URL.
Install Douban Book Notes
$ npx skills add digoal/blog --skill douban-book-notes -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install digoal/blog douban-book-notes --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/digoal/blog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/douban-book-notes .claude/skills/douban-book-notes && 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 "douban-book-notes" agent skill from https://github.com/digoal/blog/tree/master/skills/douban-book-notes into .claude/skills/douban-book-notes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "douban-book-notes", 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/digoal/blog/tree/master/skills/douban-book-notesType 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 digoal/blog --skill douban-book-notes -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install digoal/blog douban-book-notes --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/douban-book-notes .agents/skills/douban-book-notes && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "douban-book-notes" agent skill from https://github.com/digoal/blog/tree/master/skills/douban-book-notes into .agents/skills/douban-book-notes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "douban-book-notes", 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 digoal/blog --skill douban-book-notes -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install digoal/blog douban-book-notes --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/douban-book-notes .cursor/skills/douban-book-notes && 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 "douban-book-notes" agent skill from https://github.com/digoal/blog/tree/master/skills/douban-book-notes into .cursor/skills/douban-book-notes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "douban-book-notes", 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/digoal/blog.git --path skills/douban-book-notes--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 digoal/blog --skill douban-book-notes -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install digoal/blog douban-book-notes --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/douban-book-notes .gemini/skills/douban-book-notes && 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 "douban-book-notes" agent skill from https://github.com/digoal/blog/tree/master/skills/douban-book-notes into .gemini/skills/douban-book-notes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "douban-book-notes", 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 digoal/blog douban-book-notesInstalls 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 digoal/blog --skill douban-book-notes -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/douban-book-notes .github/skills/douban-book-notes && 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 "douban-book-notes" agent skill from https://github.com/digoal/blog/tree/master/skills/douban-book-notes into .github/skills/douban-book-notes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "douban-book-notes", 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 digoal/blog --skill douban-book-notes -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install digoal/blog douban-book-notes --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/douban-book-notes .opencode/skills/douban-book-notes && 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 "douban-book-notes" agent skill from https://github.com/digoal/blog/tree/master/skills/douban-book-notes into .opencode/skills/douban-book-notes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "douban-book-notes", 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
douban-book-notes- GitHub stars
- 8.6k
- Token cost
- ~1.2k tokens
- SKILL.md length
- 579 words
- Files
- 3 (incl. references)
- Skills in repo
- 98
- Repo updated
- First seen
- Licence
- GPL-2.0
At a glance
Generate a source-backed, shareable Chinese Markdown reading note from a Douban book URL.
- Works in 7 steps: Parse the Douban URL and identify the… → Search the web for high-quality… → Keep only reliable materials. Prefer… → …
- The user provides a Douban book link and asks for 读书笔记
- SKILL.md covers Goal, Workflow, Research Rules and Required Output, plus 1 more section
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Douban Book Notes is an agent skill from digoal/blog. Generate a source-backed, shareable Chinese Markdown reading note from a Douban book URL. Use when the user provides a Douban book link and asks for 读书笔记, book notes, book summary, reading reflection, 图文并茂笔记, or a Markdown article that combines book metadata, high-quality external research, the author's argument, evidence, logic, assumptions, insights, transferability, and personal reflection saved under the current project's markdown directory.
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/note_framework.md`).
It sits in Documents & Office, covering Markdown. The repository describes itself as: AI,Opensource,Database,Business,Finance,Minds. git clone --depth 1 https://github.com/digoal/blog. The licence is GPL-2.0.
When your agent uses it
- The user provides a Douban book link and asks for 读书笔记
- Reading reflection
- A Markdown article that combines book metadata
- High-quality external research
Example prompts
- “/douban-book-notes”
Workflow steps
7 steps, taken from the first numbered list in SKILL.md.
- Parse the Douban URL and identify the exact book: title, author, translator if any, publisher, publication year, ISBN, original title, and…
- Search the web for high-quality materials about the book, author, historical context, interviews, reviews, lecture notes, academic or…
- Keep only reliable materials. Prefer primary or near-primary sources: publisher pages, author interviews, official talks, academic…
- Read the book's public metadata and the selected materials. If the full book text is unavailable, state that limitation and avoid…
- Load references/note_framework.md for the note structure, quality bar, and visual ideas.
- Synthesize the final Markdown in Chinese unless the user explicitly asks for another language. Combine sourced facts, source-grounded…
- Save the Markdown under the current project's markdown/ directory. Create the directory if missing. Use a filename like…
What it can do on your machine
Read from SKILL.md and the folder at commit ad6fcb7. 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.
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.
Context cost
Douban Book Notes loads about 1.2k tokens when it runs, and up to ~2.8k if it reads all its reference files. Until then it costs about 117 tokens; SKILL.md has 579 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 digoal/blog at commit ad6fcb7, republished under its GPL-2.0 licence (© digoal). 579 words, ~1,161 tokens.
Download SKILL.mdSave it as
.claude/skills/douban-book-notes/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.- name
- douban-book-notes
- description
- Generate a source-backed, shareable Chinese Markdown reading note from a Douban book URL. Use when the user provides a Douban book link and asks for 读书笔记, book notes, book summary, reading reflection, 图文并茂笔记, or a Markdown article that combines book metadata, high-quality external research, the author's argument, evidence, logic, assumptions, insights, transferability, and personal reflection saved under the current project's markdown directory.
Douban Book Notes
Goal
Create a rigorous, shareable Chinese reading note from one book's Douban URL. Treat the note as something the user can review personally, publish as an article, or explain aloud to others.
Workflow
- Parse the Douban URL and identify the exact book: title, author, translator if any, publisher, publication year, ISBN, original title, and edition caveats.
- Search the web for high-quality materials about the book, author, historical context, interviews, reviews, lecture notes, academic or professional commentary, and official publisher information. Browse current sources; do not rely only on memory.
- Keep only reliable materials. Prefer primary or near-primary sources: publisher pages, author interviews, official talks, academic reviews, serious media reviews, reputable book reviews, and high-signal long-form essays. Avoid low-effort summaries, unsourced listicles, scraped review farms, and anonymous content unless used only as weak sentiment context.
- Read the book's public metadata and the selected materials. If the full book text is unavailable, state that limitation and avoid pretending to have read non-public chapters verbatim.
- Load
references/note_framework.mdfor the note structure, quality bar, and visual ideas. - Synthesize the final Markdown in Chinese unless the user explicitly asks for another language. Combine sourced facts, source-grounded interpretation, and your own clearly labeled thinking.
- Save the Markdown under the current project's
markdown/directory. Create the directory if missing. Use a filename likeYYYYMMDD-book-notes-<book-title-slug>.md.
Research Rules
- Use direct citations with links for important factual claims, publication metadata, author statements, statistics, historical claims, and controversial interpretations.
- Separate fact, source interpretation, and your own inference. Use wording such as "资料显示", "评论者认为", "我的判断是".
- Cross-check core metadata and claims across at least two sources when possible.
- Quote sparingly. Use short excerpts only when the wording itself matters; otherwise paraphrase and cite.
- If search results are thin, say so and write a more cautious note instead of padding.
Show full SKILL.md (273 more words)Show less
Required Output
The Markdown note must include:
- Title, book metadata, source list, and a short shareable abstract.
- Historical and intellectual context: what problem the book responds to, and why it mattered then and matters now.
- Author's central claims: distinguish main thesis, secondary claims, and implicit values.
- Evidence map: data, cases, stories, concepts, and authorities the author uses to support the claims.
- 1-3 condensed examples from the book: extract representative cases, scenes, stories, experiments, or examples that best carry the author's thinking. Keep them short, explain what each example proves, and avoid inventing details unavailable from the book or reliable sources.
- Logic map: how the argument moves from premises to conclusion.
- Assumption check: what must be true for the argument to hold, where it may fail, and what counterarguments matter.
- Thought reconstruction: what the author is really trying to change in the reader's perception or behavior.
- What I learned: concrete insights, not generic praise.
- Transfer and application: how to use the book's ideas in other domains, with examples.
- Reflection: agreement, disagreement, blind spots, and questions worth discussing.
- Share-ready section: a 3-5 minute talk track, discussion questions, and one-line takeaway.
- Visuals: include at least two useful visuals in Markdown, Mermaid, ASCII table, or inline SVG. Use visuals to explain structure, chronology, comparison, argument flow, or concept relationships.
Quality Bar
- Be analytical, not a chapter-by-chapter digest.
- Make the author's logic visible enough that a reader can teach it to someone else.
- Do not overstate certainty. Call out uncertainty, missing evidence, and source limitations.
- Keep the prose publishable: clear section headings, dense but readable paragraphs, and no filler.
- End with a concise bibliography or source notes section.
© digoal, GPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 2 other files (references) in skills/douban-book-notes of digoal/blog.
- SKILL.md
- agents/openai.yaml
- references/note_framework.md
Open the folder on GitHubat commit ad6fcb7
Compare with similar skills
Douban Book Notes 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 |
|---|---|---|---|---|---|---|
| Douban Book Notes this skilldigoal/blog | 8.6k | — | ~1.2k | Automated safety check: Pass | GPL-2.0 | |
| Markdown Article FormatterJimLiu/baoyu-skills | 26k | 6 repos | ~3.5k | Automated safety check: Pass | MIT | |
| MarkitdownImCa0/just-laws | 782 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Obsidian MarkdownAtmosphere/atmosphere | 3.8k | 20 repos | ~1.3k | Automated safety check: Pass | Apache-2.0 | |
| Gzh Designisjiamu/gzh-design-skill | 3.9k | 1 repos | ~2.2k | Automated safety check: Pass | AGPL-3.0 | |
| Crosspostingwasp-lang/wasp | 19k | — | ~1.1k | Automated safety check: Pass | MIT |
Similar skills
Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
Obsidian Markdown
Atmosphere/atmosphere
Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.
Gzh Design
isjiamu/gzh-design-skill
微信公众号文章排版引擎，将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取，自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入（非 Markdown…
Crossposting
wasp-lang/wasp
Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.
- Official
Review The Docs
supabase/supabase
Review Supabase docs changes locally in your supabase/supabase checkout — either an open PR (triage, classify, verify) or your own branch before opening a PR (local self-review).
More from digoal/blog
All 98 skills in this repoArticle Fact Checker
digoal/blog
三层审查模型,逐段逐句验证文章真伪、证据链与逻辑结构。Use when the user asks to fact-check, verify, audit, or evaluate the credibility of an article, essay, report, opinion piece, social-media post, or any written claim —…
Find Postgres Bug
digoal/blog
Find latent bugs in a local PostgreSQL source tree (RELxxSTABLE branch or HEAD) the way a core hacker does: build a heavily-poisoned debug instance (cassert + cache-discard + -O0/-ggdb3 + core…
Digoal
digoal/blog
Portable digital employee distilled from digoal's personal blog for PostgreSQL, PolarDB, DuckDB, AI+database, vector/RAG, database operations, source-code reading, technical content creation…
Paper Interpretation
digoal/blog
从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读，并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF…
Product Multi Role Analysis
digoal/blog
Analyze a product from documentation, websites, PDFs, articles, release notes, pricing pages, app listings, reviews, filings, or related links; save separate intermediate analyses from seven roles…
Blog Cover Poster
digoal/blog
Turn a blog post, article, notes, or any source material into a set of vertical poster images — one cover plus several coherent content slides that explain the core points.
Related
Categories
Questions about Douban Book Notes
What does Douban Book Notes do?
Generate a source-backed, shareable Chinese Markdown reading note from a Douban book URL. Douban Book Notes is an agent skill from digoal/blog. Generate a source-backed, shareable Chinese Markdown reading note from a Douban book URL.
When should I use Douban Book Notes?
Douban Book Notes fits situations like: the user provides a Douban book link and asks for 读书笔记; reading reflection; A Markdown article that combines book metadata; high-quality external research.
How do I install Douban Book Notes in Claude Code?
Run `npx skills add digoal/blog --skill douban-book-notes -a claude-code`. Or copy the skill folder (skills/douban-book-notes in digoal/blog) into .claude/skills/douban-book-notes in your project. Claude Code loads it when a task matches its description.
How do I install Douban Book Notes in Codex?
Run `npx skills add digoal/blog --skill douban-book-notes -a codex`. Or copy the skill folder (skills/douban-book-notes in digoal/blog) into .agents/skills/douban-book-notes in your project. Codex loads it when a task matches its description.
Can I use Douban Book Notes 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 digoal/blog --skill douban-book-notes -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/douban-book-notes, .gemini/skills/douban-book-notes, .github/skills/douban-book-notes and .opencode/skills/douban-book-notes in your project.
What does Douban Book Notes need to run?
SKILL.md names no scripts, command-line tools or credentials: Douban Book Notes is instructions for the agent only.
Does Douban Book Notes 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 Douban Book Notes 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 Douban Book Notes use?
Douban Book Notes is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Douban Book Notes use?
About 1.2k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.
What are the alternatives to Douban Book Notes?
Skills that share tags, products or a category with Douban Book Notes: Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars), Markitdown (ImCa0/just-laws, 782 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and Gzh Design (isjiamu/gzh-design-skill, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Douban Book Notes?
digoal (a GitHub user) maintains it in digoal/blog, which has 8,586 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on October 9, 2026.
Source: digoal/blog on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.