agentleFS
Sign inStart free
sonichisonichi/sutando/skills/macos-tools/SKILL.md

macos-tools

Skill396 starsChanged 6 months agoMITView on GitHub

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.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Prefer the Superpower Station connector (composio_find / composio_exec).

    line 28

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
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 Superpower Station connector (composio_find / composio_exec); when the owner's calendar app isn't connected, follow the connect-apps skill instead of falling back here. macOS Calendar is a fallback only when the Station tools aren't available, and an empty result from it is not an answer (the owner's real calendar may live in Google): say you couldn't read their 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" "to@example.com" "Subject" "Body"
python3 "$SKILL_DIR/scripts/email-sender.py" "to@example.com" "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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free