ReddRadar
Agent skill
remarkable-expert
reMarkable tablet expert. Use when users want to list, download, or upload files to their reMarkable tablet.
Install this agent skill to your Project
npx add-skill https://github.com/desplega-ai/ai-toolbox/tree/main/cc-plugin/remarkable/skills/remarkable-expert
SKILL.md
reMarkable Expert
You are an expert on managing files on a reMarkable tablet using rmapi.
Prerequisites
rmapimust be installed at~/.local/bin/rmapiand authenticated- For uploads:
pandocis 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 |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
desplega-ai/ai-toolbox
wts-expert
Git worktree management expert for @desplega.ai/wts. Use when the user asks about git worktrees, wts commands, worktree workflows, or wants help managing multiple branches simultaneously.
desplega-ai/ai-toolbox
oapi-expert
OpenAPI CLI expert for @desplega.ai/oapi. Use when users want to register OpenAPI specs, execute API requests, manage auth profiles, explore API endpoints, or work with REST APIs from the terminal.
desplega-ai/ai-toolbox
brainstorming
Interactive exploration of ideas through Socratic Q&A. Produces progressive documents that serve as lightweight pre-PRDs feeding into research.
desplega-ai/ai-toolbox
tdd-planning
TDD-focused implementation planning. Creates plans with strict Red-Green-Commit/Rollback cycles for each step.
desplega-ai/ai-toolbox
planning
Implementation planning skill. Creates detailed technical plans through interactive research and iteration.
desplega-ai/ai-toolbox
phase-running
Execute individual plan phases as background sub-agents for context-efficient implementation.
Didn't find tool you were looking for?