Reading intelligence — log books, capture quotes, and surface reads when they're relevant. One markdown file per book in pages/. Use when logging a new book,...
SKILL.md

---

name: pages
description: Reading intelligence — log books, capture quotes, and surface reads when they're relevant. One markdown file per book in pages/. Use when logging a new book, searching for what you've read, or asking "what have I read about X?"
metadata:
  openclaw:
    emoji: "📖"
    os: ["linux", "darwin", "win32"]
  hermes:
tags: ["reading", "books", "knowledge"]

---

# 📖 Pages — reading intelligence

## Data

**Base path** is workspace root or document root folder. On first use, create it: `mkdir -p mind/pages/`. Pages uses a `mind/pages/` folder in your workspace.

Files live in `mind/pages/`. Organised by reading status:

```
mind/
└── pages/
    ├── pagesconfig.yml
    ├── read/        ← finished
    ├── reading/     ← currently reading
    └── want/        ← want to read
```

File names: `<author-lastname>-<title-slug>.md`. Example: `taleb-antifragile.md`.
For books with no clear author (anthologies, edited volumes): use the title slug.

---
### Dataset Config — `pagesconfig.yml`

`pagesconfig.yml` lives inside the `mind/pages/` directory. Read it at the start of any session involving this skill.

```yaml
images: no (by default no, ask if you human want to feach images for pepople, warn that it is token expensive)
```

## Book File

```markdown
# Book Title

Author: Full Name
Year: 2012
Finished: 12 Feb 2026 (omit if not finished)
Rating: 5/5 (omit until finished)
Image: if `mind/pages/pagesconfig.yml` has `images: yes` add a link to an image in `../assets/slug-that-make-sense`
Tags: #philosophy #risk #systems #investing
Recommended by: [[marco-tabini]] (Peeps slug — omit if unknown)
Goodreads: link to goodreads

## Notes

12 Feb 2026: key insight, what changed your mind, what you'd tell someone else

## Quotes

> "The wind extinguishes a candle and energizes fire."
> — p. 61
```

**Field guidance:**

Tags: 2–4 themes, domains, or moods. Use tags you'll actually search: `#ai` not `#artificial-intelligence`, `#startups` not `#entrepreneurship`. Keep it personal.
Recommended by: if Peeps is installed, use `[[their-slug]]`; otherwise note the person's name as plain text. Creates a bidirectional trail when Peeps is present.
Notes: dated insight log, not a summary. What this book changed, challenged, or confirmed. "Good book" is not a note.
Quotes: only the lines worth keeping. One good quote beats ten mediocre ones.

**The want/ folder:** lightweight. Just title, author, and a one-line `Why:` note on why it's on your list. Add more once you start reading.

---

## Saving a Book

1. **Search the web** (title + author) — confirm full author name, publication year.
2. **Determine folder** — which folder to save to: `read/`, `reading/`, or `want/`.
3. **Ask as a group** (skip anything already clear):
  - If read: rating and finished date?
  - Tags — what's this book about, in your words?
  - Any quotes or notes to capture right now?
  - Who recommended it?
  4. if `images: yes` in `mind/pagesconfig.yml` search for a conver image and add it to **Image:** feild 

Show a brief confirmation: "Saved — *Antifragile* by Nassim Taleb, 2012, in read/. Tagged #philosophy #risk #systems."

---

## Core Behavior

- User mentions a book → check if saved, offer to create or update
- User asks "what have I read about X?" → search `mind/pages/` with expanded keywords
- User finishes a book → ask for a rating and a note
- User mentions someone recommending a book → save with `Recommended by:`; if Peeps is installed, optionally add a note to their Peeps file
- User shares a quote → append to the book file with today's date
- Conversation touches a theme → surface relevant reads contextually without being asked

**Examples:**

- "Just finished Thinking, Fast and Slow" → check if saved, offer to rate and note
- "I need to think about decision-making under pressure" → "You read *Thinking, Fast and Slow* in 2024 and tagged it #decision-making — your note says it reframed how you think about bias"
- "Priya said I should read *The Mom Test*" → save to `mind/pages/want/` with `Recommended by: [[priya-nair]]` if Peeps is installed, otherwise note her name as plain text

---

## Finding Books

Use `grep` with expanded terms. Always broaden the query before searching.

```bash
# Books on a topic
grep -ril "decision\|bias\|judgement\|psychology" mind/pages/

# Highly-rated reads
grep -rl "Rating: 5" mind/pages/read/

# Books recommended by a specific person
grep -rl "\[\[priya" mind/pages/

# Currently reading
ls mind/pages/reading/

# Books with captured quotes
grep -rl "^>" mind/pages/
```

**Keyword expansion examples:**

- "business" → `business\|strategy\|management\|leadership\|startup\|founder`
- "productivity" → `productivity\|focus\|habits\|deep.work\|flow\|systems`
- "tech / AI" → `ai\|machine.learning\|software\|internet\|tech\|silicon`
- "philosophy" → `philosophy\|stoic\|ethics\|meaning\|existence\|wisdom`

Always read the full book file after grepping — matched tags are a signal, not the full picture.

---

## Heartbeat or cron

Check a random book file. Surface something worth mentioning:

- "You finished *Antifragile* three months ago and never rated it — worth a quick reflection?"
- "You added *The Mom Test* to your want list in January — still on your radar?"
- "Priya and you have both tagged #systems — you might be reading similar things."

If nothing worth mentioning, skip.

---

## Adding to HEARTBEAT.md or cron

If it is not there yet, ask your human if they want to add **Pages: check** to HEARTBEAT.md. If there is no HEARTBEAT.md, suggest to create a cron every 30 minutes during waking hours (`*/30 7-22 * * *`) to execute **Pages: check**.

---

## Config — `pagesconfig.yml`

Optional. Lives inside `mind/pages/`.

```yaml
owner: jane-smith  # your Peeps slug — used for cross-referencing shared reads
```

If Peeps is installed and `peepsconfig.yml` exists, owner is inferred automatically — no need to duplicate.

---

## Integration with Peeps

If Peeps is installed, books and people can be connected:

Recommended by: `[[their-slug]]` in the book file — who pointed you at this
- Optionally add a note in their Peeps file: "Recommended *Book Title* (Mar 2026)"
- When the conversation involves a person and a relevant read comes up, surface it: "You and Marco both read *Zero to One* — his note is that Thiel's distribution thinking changed how he pitches."

---

## Integration with Haah

If Haah is installed, dispatch to your circles when your reading list is thin on a topic:

- "Haah: anyone in my circles with strong reads on climate tech?"

When someone in your circle asks for book recommendations:

- Check Pages for relevant reads before answering
- Draft a reply with your actual read + rating + one sentence of context. Don't recommend books you haven't read.

---

## Updating

To update this skill to the latest version, fetch the new SKILL.md from GitHub and replace this file:

```
https://raw.githubusercontent.com/haah-ing/pages-skill/main/SKILL.md
```

---

## What NOT to Suggest

- Syncing with Goodreads or Amazon — different purpose, keep private
- Automatically importing your entire reading history — build it naturally over time
- Rating every book — only rate when you have something to say
- Summaries or book reports — this is a memory layer, not a study tool
- Adding books to others' want lists on their behalf — your list, your choices
Pages: Books that stay with you.

SKILL.md

related skills
