Get the FREE Ultimate OpenClaw Setup Guide →

apple-notes

npx machina-cli add skill IvanCampos/agents/apple-notes --openclaw
Files (1)
SKILL.md
3.1 KB

Apple Notes

Run Apple Notes-driven automations with deterministic, sequential execution.

Quick Start

scripts/run_checklist_note.sh "AGENT TODO LIST"

If no title is provided, the script defaults to AGENT TODO LIST.

Fast Path: run ToDos

When the request is run ToDos (or run todos), execute the default checklist immediately:

scripts/run_checklist_note.sh "AGENT TODO LIST"

Skip preflight CRUD/search steps unless the user asks for them explicitly.

For direct Notes CRUD/search operations:

scripts/manage_notes.sh search --query "visionOS" --field any --limit 20

Workflow

  1. Resolve note by exact title across all Notes accounts/folders.
  2. Extract checklist <li> items in source order and detect completion state.
  3. Run only unchecked items (completed items are skipped).
  4. Dispatch each unchecked item through natural shortcuts or skill routing.
  5. After each successful action, mark that checklist item as completed in Notes.
  6. Stop on first failure (non-zero exit).

Checklist Syntax

  • Natural shortcuts:
    • Say <phrase>
    • Confetti
    • Record my screen for <N> seconds
  • Skill routing:
    • <skill-name>: <args>
    • Example: open-meteo-weather: --location "Boston, MA"
    • Example: apple-reminders: today --json
    • Example: apple-notes: search --query "visionOS" --field any

Supported Skills Via <skill-name>: <args>

  • apple-notes
  • apple-reminders
  • bird-x
  • browser-use
  • confetti
  • discord
  • ffmpeg-video-editor
  • git-search
  • imsg
  • launchd-non-apple-jobs
  • mailapp-send-email
  • open-meteo-weather
  • openai-docs
  • opml-reader
  • playwright
  • say
  • screen-recorder
  • swiftui-performance-audit
  • video-transcript-downloader
  • yahoo-finance
  • youtube
  • yt-video-downloader
  • skill-creator
  • skill-installer

Tool-centric skills and skills missing required local CLIs are dispatched via codex exec fallback.

Matching is case-insensitive. Empty checklist lines are skipped.

Apple Notes CRUD/Search

Use scripts/manage_notes.sh to create, read, update, delete, search, and list Apple Notes.

Examples:

scripts/manage_notes.sh create --title "My Note" --body "<div>Hello</div>"
scripts/manage_notes.sh read --title "My Note" --format plaintext
scripts/manage_notes.sh update --title "My Note" --title-new "My Renamed Note" --body "<div>Updated</div>"
scripts/manage_notes.sh search --query "Updated" --field any --limit 20
scripts/manage_notes.sh delete --title "My Renamed Note"
scripts/manage_notes.sh list --limit 50

scripts/

  • run_checklist_note.sh: Read an Apple Note and execute supported checklist items sequentially.
  • dispatch_skill_item.sh: Dispatch one checklist item to a supported skill action.
  • manage_notes.sh: Create, read, update, delete, search, and list Apple Notes.
  • manage_notes.applescript: AppleScript backend used by manage_notes.sh.

Source

git clone https://github.com/IvanCampos/agents/blob/main/skills/apple-notes/SKILL.mdView on GitHub

Overview

Apple Notes-driven automations read a note's checklist items in source order and execute unchecked items sequentially. It resolves the note by exact title across all accounts and can dispatch each item to natural shortcuts or other skills. After a successful action, it marks the checklist item as completed to keep state in Notes.

How This Skill Works

The workflow resolves the note by exact title, extracts unchecked checklist items in source order, and dispatches each to a shortcut or skill route. After every successful action, it marks the item completed in Notes and continues; it stops on the first non-zero exit.

When to Use It

  • You need to run tasks listed in a specific Apple Notes checklist such as AGENT TODO LIST
  • You want to run the default checklist quickly via the fast path by saying run ToDos
  • You want to fetch the text body of a note for automation using the manage_notes.sh read command
  • You want to perform CRUD or search operations on Apple Notes with manage_notes.sh
  • You want to dispatch each checklist item to another skill or shortcut during execution

Quick Start

  1. Step 1: Run the AGENT TODO LIST: scripts/run_checklist_note.sh 'AGENT TODO LIST'
  2. Step 2: Use the fast path to run the default checklist by issuing run ToDos
  3. Step 3: For direct note operations, manage notes with scripts/manage_notes.sh (e.g., search or read)

Best Practices

  • Resolve the exact title case-insensitively to locate the note
  • Process only unchecked items in source order
  • Dispatch items via natural shortcuts or skill routing as described in the Checklist Syntax
  • Mark each successful item completed to keep state in Apple Notes
  • Stop on first failure to avoid cascading errors

Example Use Cases

  • scripts/run_checklist_note.sh 'AGENT TODO LIST'
  • Use the fast path by issuing a run ToDos command to trigger the default checklist
  • scripts/manage_notes.sh search --query 'visionOS' --field any --limit 20
  • scripts/manage_notes.sh read --title 'VisionOS Overview' --format plaintext
  • apple-notes: search --query 'visionOS' --field any

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers ↗