Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/spillwavesolutions/automating-mac-apps-plugin/automating-contactsnpx skills add SpillwaveSolutions/automating-mac-apps-plugin --skill automating-contactsgit clone --depth 1 https://github.com/SpillwaveSolutions/automating-mac-apps-pluginWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/spillwavesolutions/automating-mac-apps-plugin/automating-contacts)<a href="https://agentmods.dev/skills/spillwavesolutions/automating-mac-apps-plugin/automating-contacts"><img src="https://agentmods.dev/badge/skills/spillwavesolutions/automating-mac-apps-plugin/automating-contacts.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00072 | $0.01069 |
| Opus 5 | $0.00036 | $0.00535 |
| Sonnet 5 | $0.00014 | $0.00214 |
| Haiku 4.5 | $0.00007 | $0.00107 |
Grade A, and why
automating-contacts scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 95 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Automating Contacts (JXA-first, AppleScript discovery)
Relationship to Other Skills
- Standalone for Contacts: Use this skill for Contacts-specific operations (querying, CRUD, groups).
- Reuse
automating-mac-appsfor: TCC permissions setup, shell command helpers, UI scripting fallbacks, and ObjC bridge patterns. - Integration: Load both skills when combining Contacts automation with broader macOS scripting.
- PyXA Installation: To use PyXA examples in this skill, see the installation instructions in
automating-mac-appsskill (PyXA Installation section).
Core Framing
- Contacts dictionary is AppleScript-first; discover there, implement in JXA
- Object specifiers: read with methods (
name(),emails()), write with assignments - Multi-value fields (emails, phones, addresses) are elements; use constructor +
.push() - Group membership:
add ... tocommand or.people.push; handle duplicates defensively - TCC permissions required: running host must have Contacts access
Workflow (default)
- Inspect the Contacts dictionary in Script Editor (JavaScript view).
- Prototype minimal AppleScript to validate verbs; port to JXA with specifier reads/writes.
- Use
.whosefor coarse filtering; fall back to hybrid (coarse filter + JS refine) when needed. - Create records with proxy +
make, then assign primitives and push multi-values;Contacts.save()to persist. - Verify persistence: check
person.id()exists after save; handle TCC permission errors. - Manage groups after person creation; guard against duplicate membership with existence checks.
- For photos or broken bridges, use ObjC/clipboard fallback; for heavy queries, batch read or pre-filter.
- Test operations: run→check results→fix errors in iterative loop.
Validation Checklist
- Contacts permissions granted (System Settings > Privacy & Security > Contacts)
- Dictionary inspected and verbs validated in Script Editor
- AppleScript prototype runs without errors
- JXA port handles specifiers correctly
- Multi-value fields pushed to arrays properly
- Groups existence checked before creation
- Operations saved and verified with
.id()checks - Error handling wraps all operations
What ships with it
8 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- references/contacts-advanced.md 1.9 KB
- references/contacts-basics.md 1.6 KB
- references/contacts-dictionary.md 1.6 KB
- references/contacts-pyxa-api-reference.md 21 KB
- references/contacts-recipes.md 1.8 KB
- scripts/export_contacts_to_csv.py 2.7 KB runs code
- scripts/import_contacts_from_csv.py 3.3 KB runs code
- scripts/search_contacts.py 5.0 KB runs code
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 6d ago First seen · 95 lines · 72 tokens per session scan A 1c304d9a7aa2
automating-contacts is a skill published in the GitHub repository SpillwaveSolutions/automating-mac-apps-plugin (40 stars, last pushed 15d ago), licensed MIT. It adds 72 tokens to every session and 1,069 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
import-audio
Moves audio files to the correct album location with proper path structure. Use when the user has downloaded WAV files from Suno or other sources that need to be organized.
catch
Shape output for a human working through agents. Use on every response, out to and including casual conversation, even when the user did not ask for brevity.
lark-workflow-standup-report
日程待办摘要：编排 calendar +agenda 和 task +get-my-tasks，生成指定日期的日程与未完成任务摘要。适用于了解今天/明天/本周的安排。.
lark-attendance
飞书考勤打卡：查询自己的考勤打卡记录.
lark-im
飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件（支持大文件分片下载）、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive Card）、监听卡片按钮回调（card.action.trigger）。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶（添加/移除/查询置顶会话）、管理标签数据、处理卡片回调时使用。.
lark-workflow-meeting-summary
会议纪要整理工作流：汇总指定时间范围内的会议纪要并生成结构化报告。当用户需要整理会议纪要、生成会议周报、回顾一段时间内的会议内容时使用。.