AgentSkillsCN

cursor-remarkable-upload

通过本地上传脚本将markdown（包括docmgr工单文档）上传到reMarkable设备为PDF，具备安全的干运行和可选的工单结构镜像功能。适用于用户要求发送文档到reMarkable、导出markdown为PDF供reMarkable使用，或排查rmapi/pandoc/xelatex问题时。

SKILL.md
--- frontmatter
name: cursor-remarkable-upload
description: Upload markdown (including docmgr ticket docs) to a reMarkable device as PDF via a local uploader script, with a safe dry-run and optional mirroring of ticket structure. Use when the user asks to send docs to reMarkable, export markdown to PDF for reMarkable, or troubleshoot rmapi/pandoc/xelatex.

Cursor Remarkable Upload

Overview

Safely convert .md to .pdf and upload to a reMarkable device, defaulting to dry-runs and avoiding overwrites.

Preconditions

  1. •Confirm uploader exists: python3 /home/manuel/.local/bin/remarkable_upload.py --help
  2. •Confirm dependencies if needed: rmapi, pandoc, xelatex

Workflow (safe default)

  1. •Choose markdown file(s) (use absolute paths).
  2. •Dry-run:
    • •python3 /home/manuel/.local/bin/remarkable_upload.py --dry-run /abs/path/to/doc.md
  3. •Upload (no overwrite):
    • •python3 /home/manuel/.local/bin/remarkable_upload.py /abs/path/to/doc.md
  4. •Only if explicitly requested: overwrite with --force.

Ticket-aware uploads

  • •Prefer mirroring ticket structure to avoid name collisions; see references/remarkable.md.

Reference

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