reader-recap

Generate a structured briefing from Readwise Reader activity within a configurable time window.

Updated May 18, 2018

Search Tags:#automation #highlights #persona #recap #briefing #readwise #reading-management

Ready to run

npx skills add https://github.com/812lcl/dotfiles --skill reader-recap

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: reader-recap
Source: https://github.com/812lcl/dotfiles/tree/main/.agents/skills/reader-recap
Command: npx skills add https://github.com/812lcl/dotfiles --skill reader-recap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly convert your Readwise Reader activity into a concise, actionable briefing that captures completed reads, highlights, and your notes.

Core Features & Use Cases

Fetch recent documents from Readwise Reader (archive or later) and deduplicate results by document ID.
Identify engagement by highlights and notes (annotated vs. highlighted-only vs. no engagement) and extract actionable insights.
Generate a structured, natural-language briefing that weaves in per-document context and any document-level notes, suitable for sharing or personal reflection.
If a persona file exists, tailor the briefing tone to your preferences.

Quick Start

Ask me to generate a reader recap briefing for the last 1 day from Readwise Reader

Frequently Asked Questions about reader-recap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I summarize Readwise Reader highlights into a daily briefing?▼

To summarize Readwise Reader highlights, this Skill fetches your archived or 'later' documents within a configurable time window, classifies engagement levels, and weaves in document notes to produce a structured narrative recap.

What is the best way to generate an actionable recap from my reading highlights?▼

Generating an actionable recap involves fetching recent reading activity, deduplicating documents by ID, and classifying highlights by engagement to extract insights, resulting in a readable briefing for personal reflection.

Does this recap automation require any specific metadata files to function?▼

Yes, the recap automation requires frontmatter metadata containing the name and description in the SKILL.md file to process your Readwise Reader activity correctly.

Can I customize the tone of my reading management briefing?▼

You can customize the briefing tone by creating an optional reader_persona.md file, which allows the Skill to tailor the narrative output to your specific preferences.

How are highlights classified when automating a Readwise Reader recap?▼

Highlights are classified by engagement levels, distinguishing between annotated documents, highlighted-only items, and no engagement reads to extract actionable insights for the briefing.

What limitations exist when generating briefings from Readwise archives?▼

Briefing generation is limited to documents within a configurable time window from either the archive or 'later' list, requiring existing highlights or notes to produce meaningful narrative output.