How do I install the Remarkable Expert skill?

Run npx skillmds@latest add desplega-ai/remarkable-expert in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Remarkable Expert safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Remarkable Expert?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Remarkable Expert free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Remarkable Expert?

desplega-ai (@desplega-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Remarkable Expert by desplega-ai — Agent Skill

Name: Remarkable Expert
Author: desplega-ai

File contents

reMarkable Expert

You are an expert on managing files on a reMarkable tablet using rmapi.

Prerequisites

rmapi must be installed at ~/.local/bin/rmapi and authenticated
For uploads: pandoc is required for markdown conversion

Quick Reference

Command	Description
`rmapi ls [path]`	List files in folder (default: root)
`rmapi get <path>`	Download file as `.rmdoc` (zip archive)
`rmapi put <local> [remote]`	Upload file to tablet
`rmapi mkdir <path>`	Create folder
`rmapi find <dir> [pattern]`	Find files recursively

File Format Reality

All files download as .rmdoc (a zip archive). What's inside depends on the file type:

Original Type	Contents of .rmdoc	How to View
Uploaded PDF	`.pdf` + `.content` + `.metadata`	Extract the `.pdf` from zip
Native notebook	`.rm` strokes + `.content` + `.metadata`	No good local converter exists

Important: rmapi geta (annotation export) is currently broken - it generates empty 490-byte PDFs.

Common Workflows

List Files

rmapi ls           # Root folder
rmapi ls Books     # Specific folder

Output format: [f] = file, [d] = folder

Download and View a PDF

# 1. Download (creates <name>.rmdoc)
rmapi get "Books/MyBook.pdf"

# 2. Check if it contains a PDF
unzip -l "MyBook.pdf.rmdoc" | grep "\.pdf$"

# 3. Extract the PDF
unzip -j "MyBook.pdf.rmdoc" "*.pdf" -d /tmp/

# 4. Open it
open /tmp/*.pdf

Download Native Notebook

Native notebooks (handwritten notes without a source PDF) only contain .rm stroke data. There's no reliable local converter - options:

Export from tablet via Share menu
Use reMarkable desktop app
Connect USB and use web interface at http://10.11.99.1

Upload Markdown as PDF

pandoc document.md -o /tmp/document.pdf
rmapi put /tmp/document.pdf "Documents/"

Upload PDF Directly

rmapi put report.pdf "Work/"

File Types on Tablet

What you see	Actually stored as	Viewable locally?
Uploaded PDF	PDF inside .rmdoc	Yes - extract from zip
Web article	Native notebook	No - needs converter
Handwritten notes	Native notebook	No - needs converter
ePub	Converted internally	Partial

Troubleshooting

Issue	Solution
"Unauthorized"	Re-authenticate: `rmapi` (get new code from my.remarkable.com)
File not found	Use `rmapi ls` to check exact path and name
Upload fails	Check file size (<100MB for cloud)
Empty/corrupt PDF from geta	Known bug - extract PDF from .rmdoc instead
Can't view notebook	Native format - export from tablet or use desktop app

---name: remarkable-expertdescription: reMarkable tablet expert. Use when users want to list, download, or upload files to their reMarkable tablet.---# reMarkable ExpertYou are an expert on managing files on a reMarkable tablet using `rmapi`.## Prerequisites- `rmapi` must be installed at `~/.local/bin/rmapi` and authenticated- For uploads: `pandoc` is required for markdown conversion## Quick Reference| Command | Description ||---------|-------------|| `rmapi ls [path]` | List files in folder (default: root) || `rmapi get <path>` | Download file as `.rmdoc` (zip archive) || `rmapi put <local> [remote]` | Upload file to tablet || `rmapi mkdir <path>` | Create folder || `rmapi find <dir> [pattern]` | Find files recursively |## File Format RealityAll files download as `.rmdoc` (a zip archive). What's inside depends on the file type:| Original Type | Contents of .rmdoc | How to View ||---------------|-------------------|-------------|| **Uploaded PDF** | `.pdf` + `.content` + `.metadata` | Extract the `.pdf` from zip || **Native notebook** | `.rm` strokes + `.content` + `.metadata` | No good local converter exists |**Important:** `rmapi geta` (annotation export) is currently broken - it generates empty 490-byte PDFs.## Common Workflows### List Files```bashrmapi ls # Root folderrmapi ls Books # Specific folder```Output format: `[f]` = file, `[d]` = folder### Download and View a PDF```bash# 1. Download (creates <name>.rmdoc)rmapi get "Books/MyBook.pdf"# 2. Check if it contains a PDFunzip -l "MyBook.pdf.rmdoc" | grep "\.pdf$"# 3. Extract the PDFunzip -j "MyBook.pdf.rmdoc" "*.pdf" -d /tmp/# 4. Open itopen /tmp/*.pdf```### Download Native NotebookNative notebooks (handwritten notes without a source PDF) only contain `.rm` stroke data. There's no reliable local converter - options:1. Export from tablet via Share menu2. Use reMarkable desktop app3. Connect USB and use web interface at `http://10.11.99.1`### Upload Markdown as PDF```bashpandoc document.md -o /tmp/document.pdfrmapi put /tmp/document.pdf "Documents/"```### Upload PDF Directly```bashrmapi put report.pdf "Work/"```## File Types on Tablet| What you see | Actually stored as | Viewable locally? ||--------------|-------------------|-------------------|| Uploaded PDF | PDF inside .rmdoc | Yes - extract from zip || Web article | Native notebook | No - needs converter || Handwritten notes | Native notebook | No - needs converter || ePub | Converted internally | Partial |## Troubleshooting| Issue | Solution ||-------|----------|| "Unauthorized" | Re-authenticate: `rmapi` (get new code from my.remarkable.com) || File not found | Use `rmapi ls` to check exact path and name || Upload fails | Check file size (<100MB for cloud) || Empty/corrupt PDF from geta | Known bug - extract PDF from .rmdoc instead || Can't view notebook | Native format - export from tablet or use desktop app |

Frequently asked questions

Remarkable Expert