Source profileQuality 78/100Review permissions

sonichi/sutando/skills/macos-tools/SKILL.md

macos-tools

macOS native integrations: screen capture, calendar, reminders, contacts, email (Mail.app), Spotlight search. Use when the user asks about their screen, schedule, to-do list, contacts, or wants to send email on macOS.

Source repository stars
359
Declared platforms
0
Static risk flags
1
Last source update
2026-07-28
Source checked
2026-07-28
DecisionCompatibilityInstallWorkflowPermissionsEvidenceSource

Decision brief

What it does—and where it fits

Native macOS integrations via AppleScript. No API keys needed — works on any Mac.

Best for

  • Screen: "What's on my screen?", "help me with this", "describe what I'm looking at"
  • Calendar: "What's on my schedule?", "do I have meetings today?"
  • Reminders: "Add a reminder", "what's on my todo list?", "mark X as done"

Not for

  • Tasks that require unconfirmed production actions or broad system permissions.
  • Environments where the pinned source and install steps cannot be inspected.

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexNot declaredNo explicit evidencePortability before use
Claude CodeNot declaredNo explicit evidencePortability before use
CursorNot declaredNo explicit evidencePortability before use
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/sonichi/sutando --skill "skills/macos-tools"
Safe inspection promptEditorial

Inspect the Agent Skill "macos-tools" from https://github.com/sonichi/sutando/blob/6a8f0fccd32e5aa620a3572c8885544f144bb6fe/skills/macos-tools/SKILL.md at commit 6a8f0fccd32e5aa620a3572c8885544f144bb6fe. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

  1. 01

    When to Use

    Screen: "What's on my screen?", "help me with this", "describe what I'm looking at"

    Screen: "What's on my screen?", "help me with this", "describe what I'm looking at"Calendar: "What's on my schedule?", "do I have meetings today?"Reminders: "Add a reminder", "what's on my todo list?", "mark X as done"
  2. 02

    Tools

    Returns path to PNG screenshot. Use the Read tool on the path to view it.

    Returns path to PNG screenshot. Use the Read tool on the path to view it.Prefer the google-calendar skill if installed. Fallback to macOS Calendar:Returns name, emails, phones. Use before sending email to resolve names to addresses.
  3. 03

    Screen Capture

    Returns path to PNG screenshot. Use the Read tool on the path to view it.

    Returns path to PNG screenshot. Use the Read tool on the path to view it.
  4. 04

    Calendar

    Prefer the google-calendar skill if installed. Fallback to macOS Calendar:

    Prefer the google-calendar skill if installed. Fallback to macOS Calendar:

Permission review

Static risk signals and limitations

Runs scripts

medium · line 18

The documentation asks the agent to run terminal commands or scripts.

bash "$SKILL_DIR/scripts/screen-capture.sh"

Runs scripts

medium · line 25

The documentation asks the agent to run terminal commands or scripts.

python3 "$SKILL_DIR/scripts/calendar-reader.py" 7 # next 7 days, JSON

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score78/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars359SourceRepository attention, not individual Skill quality
Compatibility0 platformsSourceDeclared in the catalog source record
Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
sonichi/sutando
Skill path
skills/macos-tools/SKILL.md
Commit
6a8f0fccd32e5aa620a3572c8885544f144bb6fe
License
MIT
Collected
2026-07-28
Default branch
main
View the original SKILL.md

macOS Tools

Native macOS integrations via AppleScript. No API keys needed — works on any Mac.

When to Use

  • Screen: "What's on my screen?", "help me with this", "describe what I'm looking at"
  • Calendar: "What's on my schedule?", "do I have meetings today?"
  • Reminders: "Add a reminder", "what's on my todo list?", "mark X as done"
  • Contacts: "What's Bob's email?", "find contact for..."
  • Email: "Send an email to...", "draft a message to..."
  • File search: "Find my resume", "where's that PDF?"

Tools

Screen Capture

bash "$SKILL_DIR/scripts/screen-capture.sh"

Returns path to PNG screenshot. Use the Read tool on the path to view it.

Calendar

Prefer the google-calendar skill if installed. Fallback to macOS Calendar:

python3 "$SKILL_DIR/scripts/calendar-reader.py" 7          # next 7 days, JSON
python3 "$SKILL_DIR/scripts/calendar-reader.py" 1 text     # today, plain text

Reminders

python3 "$SKILL_DIR/scripts/reminders.py" list              # all incomplete
python3 "$SKILL_DIR/scripts/reminders.py" add "Call Bob"     # add reminder
python3 "$SKILL_DIR/scripts/reminders.py" add "Fix bug" "2026-03-17"  # with due date
python3 "$SKILL_DIR/scripts/reminders.py" complete "Call Bob" # mark done

Contacts

python3 "$SKILL_DIR/scripts/contacts.py" search "Bob"       # find by name

Returns name, emails, phones. Use before sending email to resolve names to addresses.

Email (Apple Mail)

python3 "$SKILL_DIR/scripts/email-sender.py" "[email protected]" "Subject" "Body"
python3 "$SKILL_DIR/scripts/email-sender.py" "[email protected]" "Subject" "Body" --draft

Sends via Mail.app. Use --draft to create without sending. Always confirm with user before sending.

Spotlight File Search

mdfind "quarterly report"                    # search by content or filename
mdfind -name "resume.pdf"                    # search by filename only

Requirements

  • macOS (uses AppleScript)
  • Calendar, Reminders, Contacts, Mail apps (built into macOS)
  • Grant Accessibility permissions if prompted