home / skills / openclaw / skills / remarkable

remarkable skill

safe

This skill sends web articles and documents to a reMarkable tablet via the cloud, converts articles to EPUB or PDF, and manages device files.

npx playbooks add skill openclaw/skills --skill remarkable

Review the files below or copy the command above to add this skill to your agents.

Files (4)

SKILL.md

2.2 KB

---
name: remarkable
description: Send files and web articles to a reMarkable e-ink tablet via the reMarkable Cloud. Upload PDFs, EPUBs, or convert web articles to readable ebooks and send them to the device. Also browse and manage files on the device. Use when the user mentions reMarkable, wants to send an article or document to their e-reader, or manage reMarkable cloud files.
---

# reMarkable Cloud

Send documents and web articles to a reMarkable tablet via the cloud API. Uses `rmapi` for cloud access.

## Setup

Install rmapi (Go required):
```bash
cd /tmp && git clone --depth 1 https://github.com/ddvk/rmapi.git
cd rmapi && go build -o /usr/local/bin/rmapi .
```

First run will prompt for a one-time code from https://my.remarkable.com/device/browser?showOtp=true

Python dependencies (for article conversion): `readability-lxml`, `ebooklib`, `requests`, `beautifulsoup4`, `lxml`.

## Commands

### Send a web article to the device

```bash
{baseDir}/scripts/remarkable.sh send-article --url "https://example.com/article" --dir /Articles
{baseDir}/scripts/remarkable.sh send-article --url "https://example.com/article" --format pdf --dir /
{baseDir}/scripts/remarkable.sh send-article --url "https://example.com/article" --title "Custom Title" --dir /Articles
```

Fetches article, extracts readable content, converts to EPUB (default) or PDF, uploads to reMarkable cloud. Device syncs automatically.

### List files

```bash
{baseDir}/scripts/remarkable.sh ls /
{baseDir}/scripts/remarkable.sh ls /Articles
{baseDir}/scripts/remarkable.sh ls "/Book Notes"
```

Output: `[f]` = file, `[d]` = directory.

### Upload a file

```bash
{baseDir}/scripts/remarkable.sh upload --file /path/to/document.pdf --dir /Books
{baseDir}/scripts/remarkable.sh upload --file /path/to/book.epub --dir /
```

### Create a folder

```bash
{baseDir}/scripts/remarkable.sh mkdir --path /NewFolder
```

### Search for files

```bash
{baseDir}/scripts/remarkable.sh find --name "article title"
```

## Notes

- EPUB is recommended for articles — reflows nicely on e-ink
- Device syncs automatically when connected to WiFi
- Auth tokens are cached by rmapi at `~/.rmapi`
- Some sites block scraping — if article fetch fails, try a different URL

Overview

This skill lets you send documents and web articles to a reMarkable e-ink tablet via the reMarkable Cloud. It uploads PDFs and EPUBs or converts web pages into readable EPUB or PDF files and pushes them to your device. You can also browse, search, create folders, and manage files stored in the cloud.

How this skill works

The skill uses the reMarkable Cloud API through rmapi for authentication and file operations. For web articles it fetches the page, extracts the readable content, converts that content into EPUB (recommended) or PDF using Python libraries, then uploads the resulting file to a specified folder in your reMarkable cloud. File listings, uploads, folder creation, and search use rmapi commands and cached auth tokens for seamless access.

When to use it

You want to read a long web article on your reMarkable tablet without ads and layout clutter.
You need to upload PDFs or EPUBs from your computer to a specific cloud folder for syncing to the device.
You want to create or organize folders on the reMarkable cloud before a reading session.
You need to search for a document already stored in your reMarkable cloud.
You prefer EPUB format for better reflow on the e-ink display.

Best practices

Install and authorize rmapi once to cache auth tokens under ~/.rmapi for smooth future operations.
Use EPUB for articles to ensure proper text reflow on the e-ink screen; use PDF for fixed-layout documents.
If article fetch fails, try an alternate URL or a different mirror — some sites block scraping.
Run conversions on a reliable network and let the device sync automatically over Wi‑Fi after upload.
Keep a simple folder structure (e.g., /Articles, /Books) so listings and searches are easier to navigate.

Example use cases

Convert a long investigative article to EPUB and push it to /Articles for offline reading on the reMarkable.
Upload a PDF research paper to /Books so it syncs to the tablet for annotation.
Create a new folder /MeetingNotes and upload meeting agendas before a commute.
List files in /Book Notes to find a previously saved chapter and open it on the device.
Search the cloud for a title to confirm it was uploaded before leaving home.

FAQ

How do I authorize the skill to access my reMarkable account?

Run the rmapi authorization flow once; it will prompt for a one-time code from your reMarkable account in a browser. Tokens are cached in ~/.rmapi.

Which format should I use for web articles, EPUB or PDF?

EPUB is recommended because it reflows nicely on the e-ink display. Use PDF if you need the original layout preserved.