New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Apple Notes Common Errors

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Diagnose and fix common Apple Notes automation errors. An agent skill from jeremylongshore/tons-of-skills-marketplace.

MITAuto-check passed

Install Apple Notes Common Errors

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill apple-notes-common-errors -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace apple-notes-common-errors --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/apple-notes-common-errors .claude/skills/apple-notes-common-errors && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
apple-notes-common-errors
GitHub stars
2.8k
Token cost
~1.5k tokens
SKILL.md length
506 words
Files
1
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Diagnose and fix common Apple Notes automation errors. An agent skill from jeremylongshore/tons-of-skills-marketplace.

  • Works in 4 steps: Identify whether the failure is… → Capture only a redacted error… → Re-run a bounded read-only check after a… → …
  • SKILL.md covers Overview, Prerequisites, Instructions and Error Reference, plus 8 more sections
  • Calls osascript

What it does

Apple Notes Common Errors is an agent skill from jeremylongshore/tons-of-skills-marketplace. Diagnose and fix common Apple Notes automation errors. Trigger: "apple notes error".

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Claude Code

The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

Example prompts

  • “apple notes error”
  • “/apple-notes-common-errors”

Requirements

  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash(osascript:*), Grep

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  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.

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash(osascript:*)
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • osascript

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • developer.apple.com
    • support.apple.com
    • osstatus.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Apple Notes Common Errors loads about 1.5k tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 506 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~28
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 506 words, ~1,455 tokens.

Download SKILL.mdSave it as .claude/skills/apple-notes-common-errors/SKILL.md (or your agent's skills folder).
name
apple-notes-common-errors
description
Diagnose and fix common Apple Notes automation errors. Trigger: "apple notes error".
allowed-tools
Read, Write, Edit, Bash(osascript:*), Grep
compatibility
Designed for Claude Code
version
1.6.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, macos, apple-notes, automation

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.

Error Reference

ErrorCodeRoot CauseFix
Not authorized to send Apple events-1743TCC denied automation permissionSystem Settings > Privacy > Automation > enable your app
AppleEvent timed out-1712Notes.app busy, hung, or not runningApplication("Notes").activate(); increase timeout with delay
Can't get application "Notes"-2700Notes.app not installed or renamedVerify with mdfind "kMDItemCFBundleIdentifier == com.apple.Notes"
Can't get folder-1728Folder name mismatch (case-sensitive)List folders first: Notes.defaultAccount.folders().map(f => f.name())
Connection is invalid-609Notes.app crashed mid-operationPause writes, relaunch through the supported user workflow, then run a read-only check
User canceled-128Security dialog dismissed or timed outRe-run and click Allow; or pre-grant via MDM profile
Can't make Note-10000Invalid HTML in note bodyValidate HTML; strip unsupported tags before creating
Application isn't running-600App quit between callsWrap in retry with Application("Notes").activate() first
Show full SKILL.md (191 more words)Show less

Diagnostic Script

bash
#!/bin/bash
echo "=== Apple Notes Diagnostics ==="
echo -n "macOS version: "; sw_vers -productVersion
echo -n "Notes.app running: "; pgrep -x Notes > /dev/null && echo "Yes" || echo "No"
echo -n "Notes.app path: "; mdfind "kMDItemCFBundleIdentifier == com.apple.Notes" 2>/dev/null | head -1
echo -n "Note count: "
osascript -l JavaScript -e 'Application("Notes").defaultAccount.notes.length' 2>/dev/null || echo "ERROR — check TCC"
echo -n "Folder count: "
osascript -l JavaScript -e 'Application("Notes").defaultAccount.folders.length' 2>/dev/null || echo "ERROR"
echo "Account names and TCC database entries intentionally omitted"
echo "=== Done ==="

Common Fixes

bash
# Verify Notes is responsive after an approved relaunch
osascript -l JavaScript -e 'Application("Notes").defaultAccount.notes.length'

# Check for stuck iCloud sync
brctl status com.apple.Notes 2>/dev/null || echo "brctl not available"

Retry Wrapper for Transient Failures

javascript
// Retry pattern for -609, -600, -1712 errors
function withRetry(fn, maxAttempts = 3) {
  for (let i = 0; i < maxAttempts; i++) {
    try { return fn(); }
    catch (e) {
      if (i === maxAttempts - 1) throw e;
      Application("Notes").activate();
      delay(2);
    }
  }
}

// Usage
const count = withRetry(() => Application("Notes").defaultAccount.notes.length);

Error Handling

IssueCauseSolution
Errors persist after consent reviewClient not approved for the invoking userReview the exact client in System Settings or approved MDM policy
iCloud notes show stale dataSync unavailablePause writes and follow supported iCloud recovery guidance
Sandbox prevents database readSIP protects TCC.dbUse osascript to test access instead of direct DB query
Script works manually, fails from cronCron has no TCC contextUse launchd with AssociatedBundleIdentifiers instead

Output

Troubleshooting produces a redacted failure classification, a scoped verification outcome, and the next owner action. It must not include account names, full note/folder listings, TCC rows, or raw job input.

Examples

For -1712, pause the affected write, run a read-only availability check after the app is ready, then compare the operation identifier with the ledger before deciding whether to retry. For -1743, stop and request consent for the exact client rather than resetting all Apple Events permissions.

Resources

Next Steps

For incident response when errors cascade, see apple-notes-incident-runbook. For TCC and security hardening, see apple-notes-security-basics.

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/.curated/apple-notes-common-errors of jeremylongshore/tons-of-skills-marketplace.

Open the folder on GitHubat commit cfae287

Compare with similar skills

Apple Notes Common Errors next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Apple Notes Common Errors compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Apple Notes Common Errors this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.5kAutomated safety check: PassMIT
Diagnose Gatewayopenclaw/openclaw392k—~670Automated safety check: PassMIT
Apple Remindersopenclaw/openclaw392k1 repos~760Automated safety check: PassMIT
Diagnosegithub/awesome-copilot40k1 repos~1kAutomated safety check: PassMIT
Apple Containersickn33/agentic-awesome-skills47k1 repos~2.5kAutomated safety check: PassApache-2.0
Apple Hignexu-io/open-design100k—~332Automated safety check: PassApache-2.0

Similar skills

  • Diagnose Gateway

    openclaw/openclaw

    Diagnose Gateway, config, secrets, channels, and port failures with read-only one-liners.

    392k GitHub stars~670 tokensUpdated today
    Auto-check passed

  • Apple Reminders

    openclaw/openclaw

    List, add, edit, complete, or delete Apple Reminders and reminder lists via remindctl.

    392k GitHub starsUsed in 1 repo~760 tokens
    Productivity & AutomationAuto-check passed

  • Diagnose

    github/awesome-copilot

    Official

    Perform a systematic diagnostic scan of an AI workflow across 5 quality dimensions — prompt quality, context efficiency, tool health, architecture fitness, and safety — producing a scored report…

    40k GitHub starsUsed in 1 repo~1k tokens
    Agent WorkflowsAuto-check passed

  • Apple Container

    sickn33/agentic-awesome-skills

    Build, run, and manage OCI/Linux containers as lightweight per-container VMs on Apple-silicon macOS using Apple's open-source container CLI, no Docker daemon required.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    DevOps & CloudAuto-check passed

  • Apple Hig

    nexu-io/open-design

    Apple Human Interface Guidelines as 14 agent skills covering platforms, foundations, components, patterns, inputs, and technologies for iOS, macOS, visionOS, watchOS, and tvOS.

    100k GitHub stars~332 tokensUpdated yesterday
    MobileAuto-check passed

  • Apple Notes Search

    sickn33/agentic-awesome-skills

    Semantic + keyword search and connection-discovery across the user's own Apple Notes via the apple-notes MCP server.

    47k GitHub starsUsed in 1 repo~2k tokens
    Agent WorkflowsAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo

  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes

  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed

  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed

  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Questions about Apple Notes Common Errors

What does Apple Notes Common Errors do?

Diagnose and fix common Apple Notes automation errors. An agent skill from jeremylongshore/tons-of-skills-marketplace. Apple Notes Common Errors is an agent skill from jeremylongshore/tons-of-skills-marketplace. Diagnose and fix common Apple Notes automation errors.

How do I install Apple Notes Common Errors in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill apple-notes-common-errors -a claude-code`. Or copy the skill folder (skills/.curated/apple-notes-common-errors in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/apple-notes-common-errors in your project. Claude Code loads it when a task matches its description.

How do I install Apple Notes Common Errors in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill apple-notes-common-errors -a codex`. Or copy the skill folder (skills/.curated/apple-notes-common-errors in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/apple-notes-common-errors in your project. Codex loads it when a task matches its description.

Can I use Apple Notes Common Errors in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill apple-notes-common-errors -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/apple-notes-common-errors, .gemini/skills/apple-notes-common-errors, .github/skills/apple-notes-common-errors and .opencode/skills/apple-notes-common-errors in your project.

What does Apple Notes Common Errors need to run?

Going by SKILL.md and its folder, Apple Notes Common Errors needs the command-line tools its instructions call (osascript). Its frontmatter pre-approves these tools: Read, Write, Edit, Bash(osascript:*), Grep. Compatibility (from SKILL.md): Designed for Claude Code.

Does Apple Notes Common Errors access the network?

SKILL.md names 3 domains. As links in the text: developer.apple.com, support.apple.com and osstatus.com. This is read from the text; nothing was executed.

Is Apple Notes Common Errors safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Apple Notes Common Errors use?

Apple Notes Common Errors is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Apple Notes Common Errors use?

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Apple Notes Common Errors?

Skills that share tags, products or a category with Apple Notes Common Errors: Diagnose Gateway (openclaw/openclaw, 392k stars), Apple Reminders (openclaw/openclaw, 392k stars), Diagnose (github/awesome-copilot, 40k stars) and Apple Container (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Apple Notes Common Errors?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.