Agent skill · software engineering · jeremylongshore
apple-notes-common-errors
Diagnose and fix common Apple Notes automation errors.
Why this skill is useful
Adds executable diagnostic and fix scripts for common Apple Notes automation errors that aren't widely documented.
What it needs
Requires osascript, sqlite3 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 Common Errors Overview Apple Notes automation errors fall into three categories: TCC permission denials from macOS security, AppleEvent communication failures between your script and Notes.app, and iCloud sync issues that cause data inconsistency. Unlike REST APIs that return HTTP status codes, Apple Events use negative OSStatus codes. This guide covers every error you are likely to encounter when automating Notes via JXA or osascript, with tested fixes for each. Prerequisites The failed job's timestamp, opaque operation identifier, and a scoped read-only authorization test. A defined owner for TCC consent and device recovery; error handling must not change system-wide privacy settings. A paused write queue for incidents that may have partially completed a mutation. Instructions 1. Identify whether the failure is authorization, application availability, or synchronization before retrying. 2. Capture only a redacted error classification and operation identifier; avoid dumping accounts, folders, or note content. 3. Re-run a bounded read-only check after a supported UI or MDM recovery action. 4. Reconcile a timed-out write against the operation ledger before retrying, then resume the queue only after owner approval. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/apple-notes-common-errors