Agent skill · software engineering · jeremylongshore
apple-notes-data-handling
Handle Apple Notes data formats: HTML body, attachments, and rich content.
Why this skill is useful
Provides specific scripts for handling Apple Notes data formats and attachments that are not commonly documented.
What it needs
Requires osascript installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Apple Notes Data Handling Overview Apple Notes stores note content as a restricted subset of HTML internally. The body() property in JXA returns this HTML, which includes <div>, <h1>-<h3>, <b>, <i>, <ul>, <li>, and Apple-specific classes for checklists and tables. Attachments (images, PDFs, sketches, scans) are embedded as <img> or object references but cannot be directly extracted via JXA — they require the attachments() property. Understanding these data formats is essential for building reliable import, export, and backup pipelines. Prerequisites Written authorization for the accounts, folders, and note categories to be exported or transformed. An encrypted destination outside a shared directory, a retention limit, and a tested restore path. A conversion test corpus containing only synthetic notes; do not use the examples as proof that Apple Notes HTML is a stable public format. Instructions 1. Scope reads to named folders and minimize collected fields before invoking osascript. 2. Write exports to a pre-created, owner-only directory and validate permissions before any data is emitted. 3. Treat HTML and attachment metadata as untrusted content: sanitize before rendering, and never execute embedded links or markup. 4. Hash or redact identifiers in operational logs; record only counts and completion state. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/apple-notes-data-handling