apple-notes-search SKILL.md skillA
apple-notes-search from francostino/opencode-skills-collection is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add francostino/opencode-skills-collection/apple-notes-search@git:20260906.7d37dc9Pins git:20260906.7d37dc9 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- francostino/opencode-skills-collection
- Path
bundled-skills/apple-notes-search/SKILL.md- Versions recorded
- 3
- Latest version
- git:20260906.7d37dc9, committed Sep 6, 2026
- First version recorded
- Jun 18, 2026
- Size
- 8,090 bytes
- Repository stars
- 87
- License
- MIT
Semantic + keyword search and connection-discovery across the user's own Apple Notes via the apple-notes MCP server. Use when the user wants to find, recall, or synthesize something from their notes, or surface non-obvious bridges/related notes. macOS, on-device.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Apple Notes search & connection-discovery
`apple-notes` is an MCP server for semantic search and connection-discovery across the
user's own Apple Notes — hybrid search, Swanson-ABC bridges, entity threads, and cited
synthesis over everything they've written. Embeddings, search, BM25, clustering, and
bridges run **on-device**; only **synthesis generation** calls an LLM (local OR cloud,
the user's choice).
This skill covers (1) the one-time setup you must walk the user through, and (2) which
tool to reach for, since the server exposes many.
## When to Use This Skill
- Use when the user wants to **find, recall, or look up** something from their own Apple
Notes ("search my notes for X", "what did I write about X", "did I ever note Y").
- Use when the user wants to surface **non-obvious connections** across their notes
("find bridges/connections across my notes", "what links X and Y", "show related notes").
- Use when the user wants to **synthesize a position** from their notes ("summarize what I
think about X from my notes", "pull together everything I've written on X").
- Also use for "index my Apple Notes", tag/folder queries, and "what's connected to X".
…Read the whole file at its exact version.
How to install
mdr add francostino/opencode-skills-collection/apple-notes-search@sha256:379f82e4fcc67439The line at the top of this page pins the label git:20260906.7d37dc9, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_hpnjwec565dwsuxp)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Jun 18, 2026 and Sep 6, 2026, about one every 40 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260906.7d37dc9 latest | 2026-09-06 | 7d37dc9 | 8,090 B | A | view · diff |
| git:20260707.168343c | 2026-07-07 | 168343c | 7,900 B | A | view · diff |
| git:20260618.c703d99 | 2026-06-18 | c703d99 | 7,645 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (8090 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
francostino/opencode-skills-collection · 87 stars · license MIT · pushed 2026-10-18 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_hpnjwec565dwsuxp GET https://markdownregistry.com/api/v1/resolve?ref=francostino/opencode-skills-collection/apple-notes-search GET https://markdownregistry.com/api/v1/blob/379f82e4fcc67439e20db149baa4735cfc7e4af9cfb5ec045a7d648757aa546e
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from francostino/opencode-skills-collection
Every file in francostino/opencode-skills-collection