For developers and researchers working with AI agents, the ability to process and personalize information is key. We're introducing book-mirror, an AI agent skill designed to bridge the gap between static book content and a reader's individual context. This tool takes any EPUB or PDF book and generates a personalized page featuring a chapter-by-chapter analysis. It’s built for anyone looking to engage with their reading material on a deeply personal level, moving beyond standard summaries to find direct relevance within their own experiences and knowledge base.
How the Skill Works
The process this skill follows is structured and clear, encompassing six distinct stages from input to output. It begins by acquiring the book file, which can be either an EPUB or PDF format. This initial step ensures the skill has access to the complete textual content. Next, the tool efficiently extracts the raw text from each individual chapter of the acquired book. This segmentation is crucial for the subsequent chapter-by-chapter analysis. Following text extraction, a critical stage involves gathering reader context. This is not a superficial lookup; it's achieved through deep brain searches specific to the individual user, pulling relevant personal information, past thoughts, and documented situations. This comprehensive contextual data forms the indispensable basis for the personalization aspect.
With the chapter texts and reader context in place, the system then fans out read-only subagents. Each of these subagents is specifically tasked with analyzing a particular chapter. It's important to note that these subagents operate with restricted access, strictly limited to search and get_page functions within the user's broader brain environment, ensuring data privacy and security. Their work is also continuously overseen by quality-assurance gates to maintain accuracy and relevance. Once the individual chapter analyses are complete, the platform assembles all the results into a single, cohesive markdown page. This structured output is consistently stored at the designated path: media/books/<slug>-personalized.md, where <slug> is derived from the book title. As an optional final step, the generated markdown content can also be rendered to a more universally accessible PDF format, offering flexibility in how the personalized analysis is consumed.
The Chapter and The Mirror
The core output of this platform is a unique dual presentation for each chapter, offering two distinct perspectives. Every chapter's analysis is displayed in two halves: 'The Chapter' and 'The Mirror'. 'The Chapter' half provides a concise yet detailed summary of the original text. Its purpose is to ensure the reader grasps the key points, arguments, and narrative flow of the original section without needing to pore over the entire chapter again. This section serves as a direct, faithful representation of the book's content.
'The Mirror' is where the truly personal engagement occurs. This second half presents connections that directly relate the chapter's themes to the reader's own life. It achieves this profound personalization by drawing extensively on the reader's own words, specific situations they have encountered, and recurring patterns of thought pulled directly from their brain data, gathered during the earlier context acquisition phase. Consider an example: if a chapter in an economics book discusses the principles of market cycles, The Mirror might draw connections to specific investment decisions you've documented, periods of financial uncertainty you've personally navigated, or even your internal dialogues about risk versus reward, all pulled directly from your personal brain data. This makes the abstract concepts immediately relatable and grounded in your lived experience.
It's important to clarify what this tool is not. It is not a generic book summary service that simply abstracts content into bullet points or brief paragraphs. Nor is it designed as a homework assigner, dictating specific tasks, questions, or critical evaluations to the reader. Furthermore, it doesn't function as a strategy consultant offering definitive solutions or actionable advice. Instead, The Mirror component observes and resonates with the chapter's themes, providing relevant personal context and reflective prompts. After presenting these personalized connections, it deliberately gets out of the way, leaving the reader complete autonomy to decide how they wish to interpret and act upon the insights. The fundamental intent is to facilitate deep personal reflection and connection with the material, not to impose directives or external judgments.
Triggering the Skill
Interacting with this skill is designed for directness and efficiency through its CLI-based interface. Users can initiate the process using specific trigger phrases, which are intuitive and clearly communicate the user's intent. The currently accepted triggers are: 'personalized version of this book', 'mirror this book', or 'apply this book to my life'. Typing one of these phrases, followed by the book identifier, directly prompts the AI agent system to begin the multi-stage analysis process for the specified EPUB or PDF. The command-line interface ensures a precise and streamlined user experience, catering to those who prefer direct interactions with their agent environment.
FAQ
Q: Is book-mirror just a book summarizer? A: No, it is not a generic book summary. It provides detailed chapter summaries ('The Chapter') alongside personalized connections ('The Mirror') drawn from your own context.
Q: What kind of reader context does 'The Mirror' use? A: 'The Mirror' gathers reader context through deep brain searches, using your own words, situations, and patterns to make connections.
Q: Can book-mirror assign me tasks or strategies? A: No, it is not a homework assigner or a strategy consultant. The mirror observes and resonates, then gets out of the way and lets the reader decide.
This tool offers a different way to engage with literature, making insights directly relevant to your personal framework. It's designed to facilitate deeper reflection on how external knowledge aligns with your internal world.
