AgentSkillsCN

remarkable-upload

使用 remarquee CLI（基于 rmapi 的工具）将 Markdown 和源文件上传为 PDF 文件至 reMarkable 设备。当用户希望将文档或示例上传、发送或导出至 reMarkable，或将多个文件打包成带有目录结构的单个 PDF，选择特定的 /ai/YYYY/MM/DD 目标路径，避免或强制覆盖文件，或排查 pandoc/xelatex/rmapi 的认证问题时，此技能将为您提供便捷的解决方案。

SKILL.md
--- frontmatter
name: remarkable-upload
description: Upload Markdown and source files to a reMarkable device as PDFs using the remarquee CLI (rmapi-backed). Use when the user asks to upload/send/export docs/examples to reMarkable, bundle multiple files into one PDF with a ToC, choose an /ai/YYYY/MM/DD destination, avoid or force overwrites, or troubleshoot pandoc/xelatex/rmapi auth.

Remarkable Upload

Preconditions

  1. •Confirm remarquee exists:
    • •remarquee status
  2. •Confirm PDF tooling if needed:
    • •pandoc, xelatex
  3. •Confirm cloud auth if needed:
    • •remarquee cloud account --non-interactive (or run without --non-interactive to complete one-time code)

Workflow (safe default, recommended)

  1. •Choose inputs (use absolute paths when possible).
  2. •Dry-run first:
    • •Single/many markdown: remarquee upload md --dry-run <path...>
    • •Bundled markdown (one PDF + ToC): remarquee upload bundle --dry-run <path...>
    • •Source code PDFs: remarquee upload src --dry-run <path...>
  3. •Upload (no overwrite):
    • •Same commands without --dry-run
  4. •Overwrite only if explicitly requested (WARNING: deletes existing document + annotations):
    • •add --force

Bundling multiple files (preferred)

  • •Bundle multiple markdown inputs into a single PDF with a clickable ToC:
    • •remarquee upload bundle <path...> --name "<doc name>" --remote-dir "/ai/YYYY/MM/DD/<folder>" --toc-depth 2
  • •Bundle multiple source files into a single syntax-highlighted PDF:
    • •remarquee upload src <path...> --bundle --include-ext .go --name "<doc name>" --remote-dir "/ai/YYYY/MM/DD/<folder>" --toc-depth 2

Tip: if you care about ToC order and titles, copy/rename files into a temp folder with numeric prefixes, then pass that directory to bundle.

Ticket-aware uploads (recommended)

  • •Put uploads under a stable ticket folder (avoids collisions):
    • •Remote: /ai/YYYY/MM/DD/<TICKET-ID>/
    • •Use --date YYYY/MM/DD (or --remote-dir ...) explicitly.
  • •Verify results:
    • •remarquee cloud ls /ai/YYYY/MM/DD/<TICKET-ID> --long --non-interactive

Legacy fallback (only if needed)

If remarquee is unavailable, the older uploader script can still be used:

  • •Dry-run: python3 /home/manuel/.local/bin/remarkable_upload.py --dry-run /abs/path/to/doc.md
  • •Upload: python3 /home/manuel/.local/bin/remarkable_upload.py /abs/path/to/doc.md
  • •Overwrite: python3 /home/manuel/.local/bin/remarkable_upload.py --force /abs/path/to/doc.md

Reference

  • •Full guide + troubleshooting: references/remarkable.md