← Back to Skills Marketplace
kingluu

Book Deep Reader

by kingluu · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
113
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install book-deep-reader
Description
Deep-read a book and produce teaching-quality notes with critical evaluation and action guidance. Use when: (1) user wants to quickly learn and understand a...
README (SKILL.md)

Book Deep Reader

Produce teaching-quality book notes: accurate on the original, structured for quick learning, detailed enough to explain to others.

Workflow

Phase 1: Identify the Book

Given a book (title, author, ISBN, or URL), gather foundational info:

  1. Search for the book using mimo_web_search — find Douban/Goodreads pages, publisher descriptions, table of contents, reviews
  2. Fetch key pages using web_fetch — Douban book page (ISBN lookup), publisher pages, review articles
  3. Identify: book structure (chapters), core framework/model, key cases, author's background
  4. For companion/sequel books: also fetch the original book's wiki/summary to cross-reference (e.g., Reinventing Organizations Wiki for the practice guide)
  5. Identify the book's central question: What problem is the author trying to solve? Why does it matter?

Phase 2: Deep Research

Gather rich source material from authoritative references:

  1. Official wiki/community sites (if they exist) — e.g., reinventingorganizationswiki.com
  2. Detailed reviews and analysis articles — not just "good book!" but substantive breakdowns
  3. Author's talks/interviews — YouTube transcripts, keynote summaries
  4. Case study databases — for books with organizational/practice cases
  5. Academic context research — what predecessors have done on this topic
  6. Comparative analysis — other books on the same topic with different viewpoints
  7. Critical reviews — challenges, limitations, controversies

Search strategy (use mimo_web_search):

  • "\x3Cbook title>" 目录 章节 内容 (for Chinese books)
  • "\x3CEnglish title>" summary chapters key concepts
  • "author name" "\x3Ckey concept>" detailed explanation
  • site:douban.com \x3CISBN> or site:goodreads.com \x3Ctitle>
  • "\x3Cbook title>" 批评 局限性 争议 (for critical reviews)
  • "\x3Cbook title>" 对比 同类书籍 不同观点 (for comparative analysis)
  • "\x3Ctopic>" 研究进展 前人研究 学术脉络 (for academic context)

Fetch at least 5-8 authoritative sources. Prioritize:

  • Table of contents and chapter structure
  • The book's own conceptual framework (models, diagrams, key distinctions)
  • Detailed case studies with data
  • Author's direct quotes and key formulations
  • Academic positioning and predecessor research
  • Critical reviews and challenges
  • Comparative analysis with similar books

Phase 3: Knowledge Extraction (5-Layer Analysis)

Extract knowledge through 5 layers, from surface to depth:

Layer 1 — Structure: What is the book's architecture?

  • Chapter outline with one-line purpose per chapter
  • How chapters connect (sequential? parallel? recursive?)
  • Visual map of the book's flow

Layer 2 — Core Framework: What is the book's central model/theory?

  • The 1-3 core concepts that everything else builds on
  • Key distinctions the author makes (e.g., X vs. Y)
  • The "before and after" transformation the book describes

Layer 3 — Chapter Details: What does each chapter teach?

  • Core question the chapter answers
  • Key knowledge points (3-7 per chapter)
  • Practical cases with concrete data
  • Actionable insights ("how to do this")

Layer 4 — Depth Mechanisms: Why do these ideas work?

  • Underlying assumptions (what must be true for this to work)
  • Causal logic (A leads to B because...)
  • Counter-arguments and how the author addresses them
  • Limitations and boundary conditions

Layer 5 — Teaching Materials: How to explain this to someone else?

  • Core quotes / memorable formulations
  • Analogies and metaphors the author uses
  • Data/evidence for responding to skepticism
  • Common misunderstandings and corrections

Phase 4: Cross-Reference and Verify

Before writing the final output:

  1. Cross-check with original sources: Every claim must trace back to an authoritative source (the book itself, the author's wiki, verified reviews)
  2. Flag uncertainty: If a detail cannot be verified, note it as "based on secondary sources" or omit it
  3. Check for omissions: Compare against the table of contents — are all chapters covered?
  4. Check for consistency: Do the chapter-level details support the overall framework? Are there contradictions?

Phase 5: Generate Output

Write the output as a .md file in the workspace. Follow the structure in references/output-template.md.

Key quality standards:

  • Accuracy over creativity: Never invent content. If unsure, search again or state the limitation
  • Specific over general: Include concrete examples, numbers, names, quotes — not just abstract descriptions
  • Structured for skimming AND deep reading: Headers, tables, and visual maps for quick scanning; detailed prose for deep understanding
  • Teaching-ready: Someone should be able to read this file and explain the book to others without having read the book itself

Phase 6: Critical Evaluation (New)

After completing the 5-layer knowledge extraction, conduct a critical evaluation:

1. Core Question Identification

  • What is the author's central question/problem?
  • Why is this question important?

2. Academic Context Positioning

  • What have predecessors achieved on this question?
  • Where does this book fit in the academic conversation?

3. Innovation Assessment

  • What unique, new answers does the author provide?
  • What new evidence, cases, or data support these answers?

4. Comparative Analysis

  • What different viewpoints exist from contemporary books on the same topic?
  • How does this book's approach differ?

5. Critical Review

  • Has the book's conclusions been challenged?
  • What are its limitations and boundary conditions?

6. Future Directions

  • What new problems and directions does the author propose?
  • What remains unresolved?

7. Cross-disciplinary Insights

  • What启发 can practitioners from other fields draw?
  • How can these ideas be applied outside the book's domain?

8. Most Inspiring Story/Case

  • Which single story or case is most memorable and impactful?
  • Why does it resonate?

9. Actionable Takeaway

  • What is ONE action the reader should take after reading?
  • How to implement it immediately?

Output File

Save to workspace as \x3Cbook-short-name>-读书笔记.md (Chinese) or \x3Cbook-short-name>-notes.md (English).

Quality Checklist

Before finalizing, verify:

  • All chapters covered with key points
  • Core framework/model clearly articulated
  • At least 3 detailed case studies with data
  • Author's key quotes included
  • Common misconceptions addressed
  • Practical "how to start" guidance included
  • Sources cited (wiki, reviews, publisher pages)
  • No invented or unverified content
  • Can be used to teach the book without reading it
  • Critical evaluation section completed (all 9 questions answered)
  • Actionable takeaway identified with implementation steps
  • Cross-disciplinary insights clearly articulated
Usage Guidance
This skill appears to do what it says: perform web research and produce structured teaching notes. Before installing or running it, consider: (1) the skill will fetch many external pages — verify that the agent's web_fetch/search tools follow your privacy/usage policies; (2) it may try to cite or quote material that is paywalled or copyrighted — provide any paywalled text yourself if you want inclusion, and review quotations for copyright concerns; (3) check generated notes for hallucinated quotes or misattributed claims and require source links for key assertions; (4) outputs can be long and may include verbatim passages from sources — review before sharing externally. If you need stricter control, restrict autonomous invocation or run the skill only interactively so you can review web fetches and final output.
Capability Analysis
Type: OpenClaw Skill Name: book-deep-reader Version: 1.0.1 The skill is a legitimate tool designed to research books and generate structured, high-quality study notes. It utilizes standard web search and fetch capabilities (mimo_web_search, web_fetch) to gather information from public sources like Douban, Goodreads, and publisher websites. The instructions in SKILL.md and the supporting documentation in the references/ directory are focused entirely on knowledge extraction, critical evaluation, and formatting, with no evidence of data exfiltration, malicious execution, or harmful prompt injection.
Capability Assessment
Purpose & Capability
Name/description match the instructions: the SKILL.md describes multi-stage web research, extraction, verification, and writing a teaching-quality .md — all expected for a 'deep reader' skill. It does not request unrelated credentials, binaries, or system access.
Instruction Scope
Instructions explicitly call agent web tools (mimo_web_search, web_fetch) to gather publisher pages, Douban/Goodreads, author interviews, wikis, and case studies and then produce a .md. This is within scope, but the runtime behavior will perform broad web fetching and may attempt to access PDFs or other full-texts; the skill does not request user credentials for paywalled sources, so results depend on the agent's fetch capability. Users should expect the skill to aggregate and quote external material and verify citations.
Install Mechanism
No install spec and no code files — instruction-only means nothing is written to disk by the skill itself. This is the lowest-risk install profile and consistent with the skill's purpose.
Credentials
The skill declares no environment variables, credentials, or config paths. Its listed data needs (publisher pages, wikis, reviews, transcripts) align with that: no secrets or unrelated service tokens are requested.
Persistence & Privilege
Skill is not always-enabled and does not request elevated platform privileges. It only uses standard agent web/search tools and writes its output to the workspace as described; nothing in the package attempts to persist or modify other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install book-deep-reader
  3. After installation, invoke the skill by name or use /book-deep-reader
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Major update: 9 new critical assessment dimensions 1. Identification of author's core problems 2. Academic context positioning 3. Evaluation of innovation contribution 4. Comparison of similar books 5. Critical review 6. Future direction 7. Cross border inspiration 8. Most inspiring stories/cases 9. Suggestions for action Now we can not only extract book knowledge, but also evaluate the value of books, provide cross-border inspiration, and formulate action plans. **Adds critical evaluation and action guidance to book notes.** - Introduced a new critical evaluation section covering academic context, challenges, limitations, comparative analysis, and future directions. - Added requirements for cross-disciplinary insights and immediately actionable takeaways. - Extended research workflow to include academic context, comparative analysis, and critical reviews. - Updated output and quality checklist to ensure critical evaluation and practical application are included. - Skill now produces teaching-quality notes that also help users assess value, limitations, and direct actions from a book.
v1.0.0
初始版本:深度读书笔记生成技能,支持五层分析框架,可生成教学级别的书籍知识体系笔记
Metadata
Slug book-deep-reader
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Book Deep Reader?

Deep-read a book and produce teaching-quality notes with critical evaluation and action guidance. Use when: (1) user wants to quickly learn and understand a... It is an AI Agent Skill for Claude Code / OpenClaw, with 113 downloads so far.

How do I install Book Deep Reader?

Run "/install book-deep-reader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Book Deep Reader free?

Yes, Book Deep Reader is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Book Deep Reader support?

Book Deep Reader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Book Deep Reader?

It is built and maintained by kingluu (@kingluu); the current version is v1.0.1.

💬 Comments