# Send Notes (Local, Apple, Notion, Obsidian & more) to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "notes",
    "name": "Notes (Local, Apple, Notion, Obsidian & more)",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/ivangdavila/notes",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/notes",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/notes",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notes",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "apple-notes.md",
      "bear.md",
      "evernote.md",
      "formats.md",
      "local.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "notes",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T12:01:16.642Z",
      "expiresAt": "2026-05-07T12:01:16.642Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notes",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notes",
        "contentDisposition": "attachment; filename=\"notes-1.1.3.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "notes"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/notes"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/notes",
    "downloadUrl": "https://openagent3.xyz/downloads/notes",
    "agentUrl": "https://openagent3.xyz/skills/notes/agent",
    "manifestUrl": "https://openagent3.xyz/skills/notes/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/notes/agent.md"
  }
}
```
## Documentation

### Setup

On first use, read setup.md for platform selection and integration guidelines.

### When to Use

User needs to capture any type of notes: meetings, brainstorms, decisions, daily journals, or project logs. Agent handles formatting, platform routing (local or external apps), action item extraction, and retrieval across all configured platforms.

### Scope

This skill ONLY:

Creates and manages markdown files in ~/notes/
Runs user-installed CLI tools (memo, grizzly, obsidian-cli, clinote) if present and configured
Calls Notion API only when user has configured Notion integration
Reads config from ~/notes/config.md to route notes to platforms

This skill NEVER:

Installs software automatically
Accesses credential files without explicit user permission
Reads files outside ~/notes/ (except platform CLIs)
Sends data to external services unless user configures that platform
Modifies system settings or other applications

### Platform Integrations (User-Installed, Optional)

This skill works 100% locally by default. External platforms require user to install tools separately:

PlatformUser InstallsUser ConfiguresData FlowLocalnothingnothingAll localApple Notesmemo CLInothingLocal (app communication)Beargrizzly CLIToken in ~/.config/grizzly/tokenLocal (app communication)Obsidianobsidian-cliVault pathLocal (file-based)NotionnothingAPI keyNetwork (api.notion.com)Evernoteclinote CLILogin via CLINetwork (Evernote servers)

Agent behavior:

Asks user which platforms they want before checking for tools
Only checks for CLI presence after user confirms interest
Falls back to local if tool unavailable
Never reads credential files without explicit permission per session

### Architecture

Memory at ~/notes/. See memory-template.md for setup.

~/notes/
├── config.md          # Platform routing configuration
├── index.md           # Search index with tags
├── meetings/          # Local meeting notes
├── decisions/         # Local decision log
├── projects/          # Local project notes
├── journal/           # Local daily notes
└── actions.md         # Central action tracker (all platforms)

### Quick Reference

TopicFileSetup processsetup.mdMemory templatememory-template.mdAll note formatsformats.mdAction item systemtracking.mdLocal markdownplatforms/local.mdApple Notesplatforms/apple-notes.mdBearplatforms/bear.mdObsidianplatforms/obsidian.mdNotionplatforms/notion.mdEvernoteplatforms/evernote.md

### 1. Route to Configured Platform

Check ~/notes/config.md for platform routing:

# Platform Routing
meetings: local          # or: apple-notes, bear, obsidian, notion
decisions: local
projects: notion
journal: bear
quick: apple-notes

If note type not configured, use local.
If platform not available (missing CLI/credentials), fall back to local with warning.

### 2. Always Use Structured Format

Every note type has a specific format regardless of platform. See formats.md for templates.

Note TypeTriggerKey ElementsMeeting"meeting notes", "call with"Attendees, decisions, actionsDecision"we decided", "decision:"Context, options, rationaleBrainstorm"ideas for", "brainstorm"Raw ideas, clusters, next stepsJournal"daily note", "today I"Date, highlights, blockersProject"project update", "status"Progress, blockers, nextQuick"note:", "remember"Minimal format, tags

### 3. Extract Action Items Aggressively

If someone says "I'll do X" or "we need to Y", that is an action item.

Every action item MUST have:

Owner: Who is responsible (@name)
Task: Specific, actionable description
Deadline: Explicit date (not "soon" or "ASAP")

Action items sync to ~/notes/actions.md regardless of which platform holds the note.

### 4. Platform-Specific Execution

After determining platform, read the corresponding file:

PlatformFileCLIlocalplatforms/local.mdnoneapple-notesplatforms/apple-notes.mdmemobearplatforms/bear.mdgrizzlyobsidianplatforms/obsidian.mdobsidian-clinotionplatforms/notion.mdcurl (API)evernoteplatforms/evernote.mdclinote

### 5. Unified Search Across Platforms

When searching notes:

Search local ~/notes/ first
Search each configured external platform
Combine results with source indicators

Example output:

Search: "product roadmap"

Local:
  [[2026-02-19_product-sync]] - meeting, ~/notes/meetings/

Notion:
  "Q1 Roadmap" - page, Projects database

Bear:
  "Roadmap Ideas" - #product #planning

### 6. Cross-Platform Action Tracking

~/notes/actions.md is the SINGLE source of truth for all action items, regardless of where the note lives.

Format includes source:

| Task | Owner | Due | Source |
|------|-------|-----|--------|
| Review proposal | @alice | 2026-02-20 | local:[[2026-02-19_sync]] |
| Update roadmap | @bob | 2026-02-22 | notion:Q1 Planning |
| Draft post | @me | 2026-02-21 | bear:#content-ideas |

### 7. Filename Convention (Local)

For local notes: YYYY-MM-DD_topic-slug.md (date first, then topic)

External platforms use their native naming/organization.

### Common Traps

Platform misconfiguration: Always verify platform is available before attempting. Fall back gracefully.
Vague deadlines: "ASAP", "soon", "next week" are not deadlines. Force explicit dates.
Missing owners: "We should do X" needs "@who will do X"
Split action tracking: Never track actions only in the external platform. Always sync to central tracker.
No retrieval tags: A note without tags is a note you will never find.

### External Endpoints

EndpointData SentWhenPurposehttps://api.notion.com/v1/pagesNote title, contentUser configures NotionCreate pageshttps://api.notion.com/v1/databases/*/querySearch queriesUser searches Notion notesQuery database

No other external endpoints. Apple Notes, Bear, Obsidian, and Evernote use local CLI tools that communicate with locally-installed apps.

### Security & Privacy

Data flow by platform:

Local: All data stays in ~/notes/. No network.
Apple Notes: Data stays local. memo CLI communicates with Notes.app via macOS APIs.
Bear: Data stays local. grizzly CLI communicates with Bear.app.
Obsidian: Data stays local. obsidian-cli reads/writes vault files.
Notion: Note content sent to api.notion.com. Requires user-provided API key.
Evernote: Note content sent to Evernote servers via clinote. Requires user login.

Credential handling:

Agent asks permission before checking for credentials
Agent never reads ~/.config/notion/api_key or ~/.config/grizzly/token without explicit user consent
User sets up credentials themselves via platform documentation

What stays local always:

Action items tracker: ~/notes/actions.md
Note index: ~/notes/index.md
Platform config: ~/notes/config.md

### Related Skills

Install with clawhub install <slug> if user confirms:

meetings — meeting facilitation and agendas
journal — daily journaling practice
documentation — technical docs

### Feedback

If useful: clawhub star notes
Stay updated: clawhub sync
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.1.3
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T12:01:16.642Z
- Expires at: 2026-05-07T12:01:16.642Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/notes)
- [Send to Agent page](https://openagent3.xyz/skills/notes/agent)
- [JSON manifest](https://openagent3.xyz/skills/notes/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/notes/agent.md)
- [Download page](https://openagent3.xyz/downloads/notes)