🎯

read-it-later

🎯Skill

from blackhaj/dotfiles

What it does

Sends markdown, HTML, or URLs to Readwise Reader for efficient saving and later reading across different sources.

read-it-later

Installation

Quick InstallInstall with npx

npx skills add https://github.com/blackhaj/dotfiles --skill read-it-later

📖 Extracted from docs: blackhaj/dotfiles

Need more details? View full documentation on GitHub →

1Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Sends markdown (rendered to HTML) or URLs to Readwise Reader for later reading. Use when an agent needs to save summaries, notes, or links to Readwise Reader.

Overview

# Read It Later (Readwise Reader)

Send markdown or URLs to Readwise Reader using Bun scripts.

Setup

Ensure Bun v1.3.8+ is installed.
Set the Readwise token in your shell profile:

```bash

export READWISE_ACCESS_TOKEN="your-token"

```

Send Markdown

Convert markdown to HTML with Bun's markdown parser and send it to Readwise Reader.

```bash

{baseDir}/scripts/send-markdown.ts "# Project Summary\n\nThis is a summary." --title "Project Summary"

```

To avoid shell escaping, stream markdown via stdin:

```bash

cat summary.md | {baseDir}/scripts/send-markdown.ts --stdin --title "Project Summary"

```

Send a URL

Use the Readwise wrapper directly to send a URL:

```bash

{baseDir}/scripts/readwise.ts url https://example.com/article --title "Example Article"

```

Send Raw HTML

```bash

cat article.html | {baseDir}/scripts/readwise.ts html --stdin --title "Article"

```

Notes

Both scripts accept --source to set the Readwise source field.
Use --url to supply a canonical URL for HTML/markdown saves (otherwise a placeholder URL is generated).
Errors are printed with response details if the Readwise API rejects the request.