manta

Round-trip documents to a Supernote Manta e-ink tablet for handwritten annotation and recovery.

Updated May 21, 2026
One-click install
npx skills add https://github.com/love-lena/skills --skill manta-love-lena
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: manta
Source: https://github.com/love-lena/skills/tree/main/skills/manta
Command: npx skills add https://github.com/love-lena/skills --skill manta-love-lena

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandoc, supernotelib, pymupdf, supernote, mashumaro.

What problem does it solve? Reviewing long documents on a screen makes deep annotation painful, and handwritten notes on an e-ink tablet are normally stranded on the device. This Skill closes the loop: it renders markdown into editorial EPUB or redline PDF formats, uploads them to a self-hosted Supernote private cloud, pulls annotated files back, and recovers what the handwriting says. ## Core Features & Use Cases - Send: Convert any markdown file into a reflowable editorial EPUB (default) or a fixed 13pt double-spaced redline PDF with a 3.5in bottom margin, then upload it to the device's /INBOX folder via the supernote cloud CLI. - Pull: Retrieve annotated work from /EXPORT — either a device-flattened PDF export or a .pdf.mark sidecar composited onto the source PDF with PyMuPDF. - Read: Dispatch an Opus subagent over per-page PNG renders of the flattened PDF to transcribe strikethroughs, insertions, and marginal notes, then merge the edits back into the source draft. - Use Case: Draft an ADR in markdown, send it to the Manta as a redline PDF, annotate it with the stylus over coffee, then run pull.sh and have an Opus pass apply the handwritten edits to the original file. ## Quick Start Send the attached markdown document to my Manta as a redline PDF so I can annotate it by hand.

Frequently Asked Questions about manta

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a markdown file to a Supernote Manta?

Run editorial.sh with the markdown file and the --to-manta flag to render an editorial EPUB and upload it to the cloud /INBOX folder. The device pulls the file on its next sync cycle. Use --pdf instead if you plan to annotate and need the ink to round-trip.

How do I get handwritten annotations back from a Supernote tablet?

Run pull.sh with the document name to download the annotated file from the /EXPORT or /INBOX cloud folders. It grabs a flattened device export directly, or composites a .pdf.mark sidecar onto the source PDF using supernote-tool and PyMuPDF when you annotated in place.

Should I send EPUB or PDF to the Supernote for annotation?

Send PDF for anything you will mark up and need back, because EPUB annotations do not reliably round-trip — the device stores ink without text context and sync creates conflict copies. EPUB is best for read-only documents since it is reflowable.

Does the Supernote Manta support bold text in EPUB files?

No, the Manta's reader honors font-family, font-size, text-align, color, and borders but drops font-weight because the serif face has no bold variant. The included epub.css works around this by rendering bold text in the sans-serif face instead.

Why are my Supernote annotations appearing on the wrong PDF pages?

Supernote stores only annotated pages in order with no recoverable page index, so flatten.sh maps the Nth annotated page onto PDF page N. If you skipped leading pages, ink shifts earlier; the Opus reading pass over rendered pages catches the mismatch.

What are the requirements for the Supernote cloud round trip?

You need pandoc, a reachable self-hosted Supernote private cloud, and a one-time supernote cloud login cached at ~/.cache/supernote.pkl. The scripts auto-build a Python 3.13+ venv with supernotelib, PyMuPDF, and the supernote client on first run.