Pages: Books that stay with you.

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,...

Security Scan

This is an instruction-only skill for keeping local markdown book files and surfacing them; it requests no credentials, has no install actions, and its behavior matches its description.

Purpose & Capability

Name/description align with the instructions: creating and searching mind/pages/, saving book metadata, capturing quotes, and linking to Peeps if present. The skill does not request unrelated binaries, env vars, or config paths.

Instruction Scope

Runtime instructions are limited to workspace-local operations (create mind/pages/, read pagesconfig.yml and book files, append notes, grep the folder). It directs the agent to 'search the web' and optionally fetch cover images when pagesconfig.yml images: yes — expected for enriching book metadata but means the agent may make external network queries when performing those steps.

Install Mechanism

No install spec is present in the registry metadata (instruction-only), so nothing is written or executed automatically. The README includes example curl/npm install snippets — those are user-run commands and not executed by the skill itself; they reference GitHub raw content (a common pattern) but should be treated as a manual install step.

Credentials

The skill declares no required environment variables, credentials, or sensitive config paths. It may read local files in the workspace (pagesconfig.yml, peepsconfig.yml) by design; that is proportional to its purpose.

Persistence & Privilege

always is false and the skill is user-invocable. The SKILL.md suggests optionally adding a Pages check to HEARTBEAT.md or creating a cron (*/30 7-22 * * *) — this is a user-facing suggestion and the skill says to ask the human first. If you accept those suggestions, the skill would run periodically; consider whether you want automated, frequent reminders.

Assessment

This skill is coherent and low-risk as provided: it stores and reads local markdown files and asks no credentials. Before installing or following README install snippets, inspect the remote SKILL.md/README URL (don’t blindly run curl from unknown sources). Be aware that enabling the optional heartbeat/cron will make the agent check your book files periodically (accept only if you want regular notifications). If you allow image fetching or web lookups, the agent may make outbound network requests to look up authors/covers; allow those only if you’re comfortable with the agent accessing the web. Finally, if you use the Peeps integration, confirm that linking across your personal files matches your desired privacy model.

📖 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.

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

Book File

# 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.

# 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/.

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