Agent skill

Apple Notes Deploy Integration

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

Deploy Apple Notes automation as a local macOS service. An agent skill from jeremylongshore/tons-of-skills-marketplace.

MITAuto-check passedDevOps & Cloud

Install Apple Notes Deploy Integration

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

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

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace apple-notes-deploy-integration --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-deploy-integration .claude/skills/apple-notes-deploy-integration && 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-deploy-integration
GitHub stars
2.8k
Token cost
~1.6k tokens
SKILL.md length
401 words
Files
1
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Deploy Apple Notes automation as a local macOS service. An agent skill from jeremylongshore/tons-of-skills-marketplace.

  • Works in 4 steps: Install a versioned artifact into a… → Bootstrap the agent in the GUI user… → Run a read-only scoped smoke test before… → …
  • Tasks that involve Deployment
  • SKILL.md covers Overview, Prerequisites, Instructions and launchd Agent (Recommended for…, plus 7 more sections
  • Calls osascript; reaches apple.com

What it does

Apple Notes Deploy Integration is an agent skill from jeremylongshore/tons-of-skills-marketplace. Deploy Apple Notes automation as a local macOS service. Trigger: "apple notes deploy".

Its SKILL.md is about 1.6k 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

It sits in DevOps & Cloud, covering Deployment. It works with macOS. 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.

When your agent uses it

  • Tasks that involve Deployment

Example prompts

  • “apple notes deploy”
  • “/apple-notes-deploy-integration”

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. Install a versioned artifact into a user-owned directory with restrictive permissions and validate the plist with plutil -lint.
  2. Bootstrap the agent in the GUI user domain; confirm its label, executable path, and environment exactly match the reviewed release.
  3. Run a read-only scoped smoke test before enabling scheduled writes.
  4. Roll back by booting out the exact label and restoring the previously approved artifact; never leave two schedules active.

What it can do on your machine

Read from SKILL.md and the folder at commit 80f86df. 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

    Hosts in commands or code, which the agent is likely to contact:

    • apple.com

    Also links to:

    • developer.apple.com
    • support.apple.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 Deploy Integration loads about 1.6k tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 401 words of instructions outside code blocks.

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

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 80f86df, republished under its MIT licence (© jeremylongshore). 401 words, ~1,559 tokens.

Download SKILL.mdSave it as .claude/skills/apple-notes-deploy-integration/SKILL.md (or your agent's skills folder).
name
apple-notes-deploy-integration
description
Deploy Apple Notes automation as a local macOS service. Trigger: "apple notes deploy".
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 Deploy Integration

Overview

Apple Notes automation runs exclusively on macOS — there is no cloud deployment path because Notes.app depends on the local Apple Events subsystem and TCC permissions. Deployment means packaging your JXA/osascript automation as a persistent local service. The three deployment models are: launchd agents for scheduled/recurring tasks, Automator workflows for user-triggered actions, and Apple Shortcuts for cross-app automation. Each has different permission requirements and lifecycle management.

Prerequisites

  • An owned interactive macOS user session, an approved launchd label, and explicit TCC consent for the actual client path.
  • Immutable versioned scripts with a tested rollback package; do not deploy from a mutable home-directory glob.
  • A restricted log directory and a non-production account or folder for initial smoke tests.

Instructions

  1. Install a versioned artifact into a user-owned directory with restrictive permissions and validate the plist with plutil -lint.
  2. Bootstrap the agent in the GUI user domain; confirm its label, executable path, and environment exactly match the reviewed release.
  3. Run a read-only scoped smoke test before enabling scheduled writes.
  4. Roll back by booting out the exact label and restoring the previously approved artifact; never leave two schedules active.
xml
<!-- ~/Library/LaunchAgents/com.yourorg.notes-automation.plist -->
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.yourorg.notes-automation</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/node</string>
        <string>/Users/you/scripts/notes-sync.js</string>
    </array>
    <key>StartInterval</key>
    <integer>3600</integer>
    <key>StandardOutPath</key>
    <string>/tmp/notes-automation.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/notes-automation-error.log</string>
    <key>EnvironmentVariables</key>
    <dict>
        <key>PATH</key>
        <string>/usr/local/bin:/usr/bin:/bin</string>
    </dict>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>
bash
# Deploy and manage the launchd agent
cp com.yourorg.notes-automation.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.yourorg.notes-automation.plist
launchctl list | grep notes-automation
# View logs
tail -f /tmp/notes-automation.log

# Unload for updates
launchctl unload ~/Library/LaunchAgents/com.yourorg.notes-automation.plist

Shortcuts Deployment (User-Triggered)

bash
# Create a Shortcut that runs your JXA script
# 1. Open Shortcuts.app > New Shortcut
# 2. Add "Run Shell Script" action with:
osascript -l JavaScript /Users/you/scripts/notes-export.js

# Trigger shortcuts from CLI or other automations:
shortcuts run "Export Notes to Markdown"
shortcuts run "Daily Note Creator" --input-type text --input "$(date +%Y-%m-%d)"

# List available shortcuts
shortcuts list | grep -i note

Installer Script

bash
#!/bin/bash
# scripts/install.sh — Deploy Notes automation to a macOS machine
set -euo pipefail

INSTALL_DIR="$HOME/.notes-automation"
PLIST_DIR="$HOME/Library/LaunchAgents"
LABEL="com.yourorg.notes-automation"

echo "Installing Apple Notes automation..."
mkdir -p "$INSTALL_DIR"
cp scripts/*.js "$INSTALL_DIR/"
cp config/*.json "$INSTALL_DIR/"

# Install launchd plist
envsubst < templates/launchd.plist.template > "$PLIST_DIR/$LABEL.plist"
launchctl load "$PLIST_DIR/$LABEL.plist"

# Verify
echo -n "Service status: "
launchctl list "$LABEL" 2>/dev/null && echo "Running" || echo "Failed to start"

# Test Notes access (will trigger TCC prompt on first run)
echo -n "Notes access: "
osascript -l JavaScript -e 'Application("Notes").defaultAccount.notes.length' && echo "OK" || echo "DENIED — approve in System Settings"
Show full SKILL.md (198 more words)Show less

Error Handling

IssueCauseSolution
launchd job starts but osascript failsTCC not granted for launchd contextRun script manually first to trigger TCC prompt; approve in System Settings
Job runs but Notes.app not openRunAtLoad fires before login completeAdd open -a Notes before osascript calls in your script
Logs show "connection invalid"Screen locked or user switchedAdd LimitLoadToSessionType: Aqua to plist for GUI session only
Shortcut not found from CLIShortcut name mismatch or not savedshortcuts list to verify exact name
Agent runs twiceBoth StartInterval and StartCalendarInterval setUse only one scheduling mechanism per plist

Output

A deployment receipt identifies the artifact version, plist label, macOS user domain, smoke-test mode, log location, and rollback version. It excludes note counts, titles, bodies, account names, and TCC database details.

Examples

Deploy a read-only health job first, verify its launchctl print output and redacted log receipt, then separately approve any write-capable job. If the smoke test fails, boot out the new label and restore the prior reviewed version before investigating.

Resources

Next Steps

For production readiness validation, see apple-notes-prod-checklist. For monitoring deployed services, see apple-notes-observability.

© 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-deploy-integration of jeremylongshore/tons-of-skills-marketplace.

Open the folder on GitHubat commit 80f86df

Compare with similar skills

Apple Notes Deploy Integration 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 Deploy Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Apple Notes Deploy Integration this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.6kAutomated safety check: PassMIT
Deploy Observabilityaliyun/alibabacloud-observability-mcp-server166—~2.6kAutomated safety check: NotesNone
Release Allpaperboytm/spool592—~1.1kAutomated safety check: PassCustom licence
OpenWork Release Validationdifferent-ai/openwork24k—~1.7kAutomated safety check: PassCustom licence
Mdm Device ManagementBagelHole/DevOps-Security-Agent-Skills1.1k—~5.7kAutomated safety check: NotesMIT
Update Quarto in RStudiorstudio/rstudio5.1k—~2.8kAutomated safety check: PassCustom licence

Similar skills

  • Deploy Observability

    aliyun/alibabacloud-observability-mcp-server

    Deploy, start, and update the Alibaba Cloud Observability MCP Server (阿里云可观测 MCP Server).

    166 GitHub stars~2.6k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check: notes
  • Release All

    paperboytm/spool

    Publish the complete Spool CLI release train: synchronized versions, npm packages, the GitHub release, and the matching production web deployment.

    592 GitHub stars~1.1k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • OpenWork Release Validation

    different-ai/openwork

    Checks a published OpenWork desktop release by booting the released macOS binaries through packaged journeys, verifying signing and updater manifests, and publishing evidence.

    24k GitHub stars~1.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Mdm Device Management

    BagelHole/DevOps-Security-Agent-Skills

    Manage and secure company devices with MDM solutions — enroll macOS, Windows, iOS, and Android devices, enforce security policies, and automate software deployment.

    1.1k GitHub stars~5.7k tokensUpdated 4 mo ago
    DevOps & CloudAuto-check: notes
  • Bumps the pinned Quarto version across the RStudio repository, mirrors the release to the rstudio-buildtools S3 bucket, verifies it and opens a PR, on macOS and Linux.

    5.1k GitHub stars~2.8k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Mac App Release

    steipete/agent-scripts

    Release workflow for Sparkle-updated macOS apps, driven by a repo-owned manifest and a shared script covering appcast, signing, GitHub Release and Homebrew closeout.

    7.3k GitHub stars~2.3k tokensUpdated 5 days ago
    DevOps & CloudAuto-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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    Auto-check passed

Works with

Categories

Questions about Apple Notes Deploy Integration

What does Apple Notes Deploy Integration do?

Deploy Apple Notes automation as a local macOS service. An agent skill from jeremylongshore/tons-of-skills-marketplace. Apple Notes Deploy Integration is an agent skill from jeremylongshore/tons-of-skills-marketplace. Deploy Apple Notes automation as a local macOS service.

When should I use Apple Notes Deploy Integration?

Apple Notes Deploy Integration fits situations like: tasks that involve Deployment.

How do I install Apple Notes Deploy Integration in Claude Code?

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

How do I install Apple Notes Deploy Integration in Codex?

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

Can I use Apple Notes Deploy Integration 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-deploy-integration -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-deploy-integration, .gemini/skills/apple-notes-deploy-integration, .github/skills/apple-notes-deploy-integration and .opencode/skills/apple-notes-deploy-integration in your project.

What does Apple Notes Deploy Integration need to run?

Going by SKILL.md and its folder, Apple Notes Deploy Integration 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 Deploy Integration access the network?

SKILL.md names 3 domains. In commands or code: apple.com; the agent is likely to contact it when it follows the instructions. As links in the text: developer.apple.com and support.apple.com. This is read from the text; nothing was executed.

Is Apple Notes Deploy Integration 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 Deploy Integration use?

Apple Notes Deploy Integration 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 Deploy Integration use?

About 1.6k tokens (SKILL.md is roughly 6.2k 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 Deploy Integration?

Skills that share tags, products or a category with Apple Notes Deploy Integration: Deploy Observability (aliyun/alibabacloud-observability-mcp-server, 166 stars), Release All (paperboytm/spool, 592 stars), OpenWork Release Validation (different-ai/openwork, 24k stars) and Mdm Device Management (BagelHole/DevOps-Security-Agent-Skills, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Apple Notes Deploy Integration?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,825 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 9, 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.