File structure
book-tracker/
SKILL.md
library.md ← every book with status, notes, rating
reading-list.md ← want to read, with reasons
config.md ← genres, preferences, monthly goal
What it tracks
In progress: What you're currently reading, where you are, any notes mid-read.
Finished: Rating, key ideas, best quotes, what changed your thinking.
Abandoned: Books you gave up on and why — this data is useful too.
Want to read: Recommendations with context (who recommended it, why it matters to you).
Adding books
Start reading: /book start [title] [author]
Finish reading: /book done [title] — triggers a brief reflection prompt
Add to list: /book want [title] — adds with optional reason
Log a note mid-read: /book note [title] [note]
Abandoned: /book drop [title] [why]
Post-reading reflection
When you mark a book as done, the agent asks 4 questions:
- What's the one idea from this book you'll actually use or remember?
- What surprised you?
- Who would you recommend this to and why?
- Rating: 1-5
Short answers are fine. One sentence each is enough.
These become the book's entry in library.md.
library.md structure
## [TITLE] — [AUTHOR]
Status: read / reading / abandoned / want
Finished: [date]
Rating: [1-5]
Genre: [fiction / non-fiction / biography / etc]
The one idea: [their answer from reflection]
Surprised by: [their answer]
Recommend to: [their answer]
Notes:
[Any mid-read or post-read notes]
Quotes:
[Any passages worth keeping]
Related to: [other books in library that connect]
Reading list intelligence
/book next — suggests what to read next based on:
- What you've enjoyed most (by rating and genre)
- Themes you've been exploring lately
- Books you've had on the list longest
- Any books that connect to what you're working on or thinking about
Not just a ranked list. A recommendation with a reason:
📖 What to read next
1. **The Mom Test** — Rob Fitzpatrick
Why now: You've been reading about product and customer research.
This is the most practical book on the list for your current work.
On your list since: 4 months ago (added when [NAME] mentioned it)
2. **Piranesi** — Susanna Clarke
Why now: You've been on a heavy non-fiction run for 3 months.
Your ratings suggest you like breaks with literary fiction.
Short. Unusual. Won't take long.
Theme tracking
After 10+ books, patterns become visible.
/book themes — what have you been reading about?
📖 Reading themes — last 12 months
Most frequent topics:
1. Product and strategy (8 books)
2. Management and leadership (5 books)
3. Literary fiction (4 books)
4. History (3 books)
Gaps you might notice:
• You haven't read much science or technology in 18 months
• Your fiction-to-non-fiction ratio is 1:4 (heavy non-fiction run)
Your highest-rated books tend to be: [genre/topic pattern]
Book and knowledge-capture integration
When you log a quote or key idea from a book:
/book note [title] "this is worth keeping"
The skill offers to add it to knowledge-capture:
"Add this to your knowledge base? It'll be searchable there alongside your other notes."
The two skills build on each other. Books feed the knowledge base.
The knowledge base surfaces relevant reading notes when you're thinking about a topic.
Reading goal
Optional. Set a books-per-month target if you want one.
/book goal [N] per month
At the end of each month, a brief note:
"Read 2 books in March, goal was 3. On track for the year (8 of 10)."
Not a guilt trip. Just a number.
Privacy rules
Reading history is personal and low-stakes, but still private.
Context boundary: Only surface reading lists and notes in the owner's private channel.
Never share what someone is reading or their book notes in a group context.
Approval gate: No book is added to or removed from the library without
the owner's instruction — either explicit command or confirmation of a suggestion.
Management commands
/book start [title] [author] — start reading/book done [title] — mark finished, trigger reflection/book drop [title] — mark abandoned/book want [title] — add to reading list/book note [title] [note] — log a note/book next — get a recommendation/book list — show reading list/book library — show all books/book themes — reading pattern analysis/book search [query] — search your library/book [title] — show entry for one book
