Apple notes

Skill IvanCampos/agents/skills/apple-notes

All things related to my Codex agents running on MacOS

Install

npx -y skills add IvanCampos/agents --skill apple-notes

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Read Apple Notes content and execute checklist-driven automations in order. Use when a user asks to run tasks from an Apple Note (especially a checklist note like "AGENT TODO LIST"), or to fetch a specific note body for automation.

SKILL.md

3.1 KB, as published. Nobody here has run it

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

Resolve note by exact title across all Notes accounts/folders.
Extract checklist <li> items in source order and detect completion state.
Run only unchecked items (completed items are skipped).
Dispatch each unchecked item through natural shortcuts or skill routing.
After each successful action, mark that checklist item as completed in Notes.
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.