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/fredchu/claude-dotfiles/apple-notesnpx skills add fredchu/claude-dotfiles --skill apple-notesgit clone --depth 1 https://github.com/fredchu/claude-dotfilesWhat 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 | $0.00093 | $0.01424 |
| Opus 5 | $0.00046 | $0.00712 |
| Sonnet 5 | $0.00019 | $0.00285 |
| Haiku 4.5 | $0.00009 | $0.00142 |
Grade A, and why
apple-notes 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 2d 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 — 121 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Apple Notes — MCP 操作規則
Gotchas (Read First)
- 所有我產生的內容一律放「Claude 工作區」資料夾 — 不碰用戶其他資料夾，除非明確要求
- 建立筆記用 AppleScript（不用 MCP create-note，因為 title 參數會標題重複）
- 格式用 HTML — Apple Notes 不渲染 markdown
- update-note 是全量覆寫 — 必須先 get-note-content 讀取現有內容，合併後再寫回
- 搜尋先用用戶原話 — 搜不到再 list-folders 看結構，最後才擴展關鍵字
- 密碼保護的筆記無法存取 — 遇到時告知用戶
macOS 26 HTML 格式規則（必遵守）
macOS 26 Notes.app 會自動加 font-size: 11px。<h2>/<h3> 在 iPhone 上會變小字。
| 格式 | HTML |
|---|---|
| 筆記標題 | <h1>...</h1> |
| 段落標題 | <div><span style="font-size: 18px"><b>...</b></span></div> |
| 內文 | <div>...</div>（不加 font-size） |
| 清單 | <ul><li>...</li></ul> 或 <ol><li>...</li></ol> |
| 空行 | <div><br></div> |
禁止：<h2>/<h3>、<p>、font-size 19px+
建立筆記的標準流程
-- 用 AppleScript 建立（避免 MCP create-note 標題重複）
tell application "Notes"
tell account "iCloud"
make new note at folder "Claude 工作區" with properties {body:"<h1>標題</h1><div>內容</div>"}
end tell
end tell
讀取/搜尋/更新用 MCP 工具即可。更新用 update-note（format: "html"），HTML 遵守上述格式規則。
更新筆記的標準流程
1. mcp__apple-notes__get-note-content → 讀取現有內容
2. 合併/修改內容
3. mcp__apple-notes__update-note
- title: "筆記標題"
- body: "完整的新內容（HTML）"
- format: "html"
搜尋筆記
1. mcp__apple-notes__search-notes
- query: "用戶的原話關鍵字"
2. 搜不到 → mcp__apple-notes__list-folders 看結構
3. 還是找不到 → 擴展同義詞再搜
常用工具速查
| 工具 | 用途 |
|---|---|
create-note |
建立筆記（需搭配 move-note） |
search-notes |
搜尋筆記（title + content） |
get-note-content |
讀取筆記內容 |
get-note-details |
取得 metadata（建立/修改時間） |
update-note |
覆寫筆記內容（先讀再寫） |
delete-note |
刪除筆記（移到 Recently Deleted） |
move-note |
搬移筆記到指定資料夾 |
list-notes |
列出所有筆記或特定資料夾內的 |
list-folders |
列出所有資料夾 |
create-folder |
建立新資料夾 |
get-note-markdown |
取得 markdown 格式（checklist 自動標 [x]/[ ]） |
get-checklist-state |
讀取 checklist 勾選狀態（需 Full Disk Access） |
batch-move-notes |
批次搬移 |
batch-delete-notes |
批次刪除 |
HTML 格式範例
<h1>筆記標題</h1>
<div><i>日期或副標題</i></div>
<div><br></div>
<div><span style="font-size: 18px"><b>段落標題</b></span></div>
<div>一般內文</div>
<div><b>粗體</b>、<i>斜體</i></div>
<ul>
<li>無序清單項目</li>
</ul>
<ol>
<li>有序清單項目</li>
</ol>
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.
- 2d ago First seen · 121 lines · 93 tokens per session scan A 623c6ac8c613
apple-notes is a skill published in the GitHub repository fredchu/claude-dotfiles (2 stars, last pushed 20d ago), licensed MIT. It adds 93 tokens to every session and 1,424 once invoked, about $0.0005 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-31.
Other skills, from other repositories
claude-handoff
为当前对话撰写一份交接摘要，让一个全新的 agent 能够继续工作。不要把摘要保存到本地，而是启动一个后台 agent，把这份摘要作为它的提示词注入：claude --bg --name " " " "。它会在当前工作目录启动并立刻返回；用户通过 claude agents 来管理它。.
wait-what
等等。上一条消息我没理解：重新解释一下。.
create-new-wiki-page
Create a new Azure DevOps wiki page. Use when the user wants to add a new wiki page, write project documentation in Azure DevOps wiki format, or update wiki page structure with mermaid diagrams in Traditional Chinese.
frankx-daily-execution
Executes Frank's daily workflow using the FrankX agent system, Starlight Intelligence, and productivity methods. Use when planning Frank's day, running a focused work sprint, or turning intentions into a concrete execution plan.
mymind
Use the local mymind CLI to initialize auth, refresh bookmark cache from access.mymind.com/cards, search bookmarks by text or regex, query tags, and shape JSON output with jq. Trigger when a user mentions "mymind", asks to find bookmarks, list tag counts, troubleshoot mymind CLI fetch errors (including CloudFront…
token-saver
Token optimization guide for Claude Code. This skill should be used when the user wants to reduce API costs, learn model routing strategies, or understand how to use free/cheaper tools (Ollama, Haiku) instead of burning expensive Claude tokens on routine tasks. Triggers on: save tokens, reduce costs, token tips, cheap…