bugjay/weread-skill

This repository is a Claude Code Skill, meaning a small package of instructions that the Claude Code tool can load to perform a specific task. The README is written in Chinese. The Skill takes reading notes exported from WeRead, a popular Chinese ebook app run by Tencent, and turns them into a personal knowledge base. WeRead lets readers save highlights, thoughts, chapters, positions, and dates from the books they read. The Skill ingests that exported Markdown or TXT file and produces a structured set of outputs: a source evidence file that keeps the author's original text and the user's comments clearly separated, a candidate notes file of high value points, atomic knowledge cards with one idea per card stored in both Markdown and JSONL form, a concept relationship map showing how ideas support, contradict, or extend each other, a set of review questions, a file of reusable application assets like writing prompts, and an index for the whole book. The README is firm about a few rules. The three voices, author original text, user comments, and AI processing, must always stay distinct. Every card must cite its book, chapter, and location. AI is told to never invent theories, chapters, or page numbers that are not in the source. The output is also designed to be ready for retrieval augmented generation systems, where each atomic card is one chunk with metadata for the book, author, chapter, location, and card type. Installation is by cloning the repo into the Claude Code skills directory, after which the Skill auto activates on Chinese trigger phrases like organize reading notes or generate atomic cards, or when a user pastes WeRead exported notes. The README also lists adaptation strategies for theory books, method books, business books, and other categories. License is MIT.