reader-recap

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

Updated May 18, 2018
One-click install
npx skills add https://github.com/812lcl/dotfiles --skill reader-recap
Or copy as Structured Prompt for Agent
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.