book-highlights-processor

name

book-highlights-processor

description

Process exported book highlights markdown files from iBooks or Zotero. Transforms raw 🎯 quote bullet points into Obsidian callouts with generated atomic-note titles and ==highlighted== key phrases. Use this skill whenever the user wants to process book highlights, enrich quotes with titles and highlights, work with iBooks/Zotero export markdown files, or asks to "обработай цитаты", "добавь заголовки к хайлайтам", "разбери экспорт из книги", "обработай импорт из iBooks/Zotero".

Book Highlights Processor

Transform exported book highlight files into enriched Obsidian callouts with AI-generated titles and highlighted key phrases.

Input format

The markdown file from iBooks or Zotero looks like this:

---
book: Book Title
author: Author Name
language: ru
tags:
- ibook/imported
- literature
---

## 📔 Книга: Book Title

**Автор**:: Author Name
...

---

# 🔍 How I Discovered IT

- 📚
    - 🎯Quote text here, possibly several sentences or paragraphs
        - ✍️Reader's own note or commentary (optional)
    - 🎯Another quote
        - ✍️Another note

What to produce

For each 🎯 quote, output an Obsidian callout:

> [!quote] Generated Title
> Quote text with ==key phrase== and ==another key phrase== highlighted.
>
> ✍️ Reader's note text

If the quote has no ✍️ note, omit the last line.

How to generate the title

The title goes into the callout header and will likely become the filename of a future Obsidian atomic note. Naming style (claim-based, 4–8 words, language rules) — see .agents/rules/file-naming.md.

Draw on the ✍️ reader note as a signal of what the reader found important — that's the insight to encode in the title, not just a paraphrase of the raw quote.

Examples from SRE context:

• "Мониторинг min/max ловит сбои, которые среднее скрывает"
• "Fallback должен существовать даже в виде тетриса"
• "Graceful Degradation требует нескольких уровней готовности"
• "Ретраи без backoff превращают деградацию в катастрофу"

How to add highlights

Add ==highlight== to 2–4 phrases per quote. Choose phrases that:

• Carry the core claim or mechanism
• Help a reader scanning the quote instantly grasp the main point
• Are short (3–8 words each)

Avoid highlighting entire sentences — pick the densest, most meaningful fragments.

Output structure

Keep the frontmatter and the header block (book title, author, link) exactly as-is.

Replace the entire - 📚 list block with sequential callouts — no list bullets, no 📚 wrapper, just callouts separated by a blank line.

The final file should look like:

---
(frontmatter unchanged)
---

## 📔 Книга: ...
(header block unchanged)

---

# 🔍 How I Discovered IT

> [!quote] First Title
> Quote one with ==highlights==.
>
> ✍️ Note one

> [!quote] Second Title
> Quote two with ==highlights==.

> [!quote] Third Title
> Long quote three with ==important phrase== somewhere in the middle.
>
> ✍️ Note three

Workflow

1. Read the full file first — understand the domain and vocabulary before generating titles.
2. Process all quotes sequentially.
3. Rewrite the file with Edit or Write, preserving frontmatter and header section.
4. If the file is very long (20+ quotes), process and write in one pass — don't ask the user to confirm each quote.