{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/notes",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notes",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "apple-notes.md",
      "bear.md",
      "evernote.md",
      "formats.md",
      "local.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/notes",
    "agentPageUrl": "https://openagent3.xyz/skills/notes/agent",
    "manifestUrl": "https://openagent3.xyz/skills/notes/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/notes/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Setup",
        "body": "On first use, read setup.md for platform selection and integration guidelines."
      },
      {
        "title": "When to Use",
        "body": "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."
      },
      {
        "title": "Scope",
        "body": "This skill ONLY:\n\nCreates and manages markdown files in ~/notes/\nRuns user-installed CLI tools (memo, grizzly, obsidian-cli, clinote) if present and configured\nCalls Notion API only when user has configured Notion integration\nReads config from ~/notes/config.md to route notes to platforms\n\nThis skill NEVER:\n\nInstalls software automatically\nAccesses credential files without explicit user permission\nReads files outside ~/notes/ (except platform CLIs)\nSends data to external services unless user configures that platform\nModifies system settings or other applications"
      },
      {
        "title": "Platform Integrations (User-Installed, Optional)",
        "body": "This skill works 100% locally by default. External platforms require user to install tools separately:\n\nPlatformUser 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)\n\nAgent behavior:\n\nAsks user which platforms they want before checking for tools\nOnly checks for CLI presence after user confirms interest\nFalls back to local if tool unavailable\nNever reads credential files without explicit permission per session"
      },
      {
        "title": "Architecture",
        "body": "Memory at ~/notes/. See memory-template.md for setup.\n\n~/notes/\n├── config.md          # Platform routing configuration\n├── index.md           # Search index with tags\n├── meetings/          # Local meeting notes\n├── decisions/         # Local decision log\n├── projects/          # Local project notes\n├── journal/           # Local daily notes\n└── actions.md         # Central action tracker (all platforms)"
      },
      {
        "title": "Quick Reference",
        "body": "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"
      },
      {
        "title": "1. Route to Configured Platform",
        "body": "Check ~/notes/config.md for platform routing:\n\n# Platform Routing\nmeetings: local          # or: apple-notes, bear, obsidian, notion\ndecisions: local\nprojects: notion\njournal: bear\nquick: apple-notes\n\nIf note type not configured, use local.\nIf platform not available (missing CLI/credentials), fall back to local with warning."
      },
      {
        "title": "2. Always Use Structured Format",
        "body": "Every note type has a specific format regardless of platform. See formats.md for templates.\n\nNote 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"
      },
      {
        "title": "3. Extract Action Items Aggressively",
        "body": "If someone says \"I'll do X\" or \"we need to Y\", that is an action item.\n\nEvery action item MUST have:\n\nOwner: Who is responsible (@name)\nTask: Specific, actionable description\nDeadline: Explicit date (not \"soon\" or \"ASAP\")\n\nAction items sync to ~/notes/actions.md regardless of which platform holds the note."
      },
      {
        "title": "4. Platform-Specific Execution",
        "body": "After determining platform, read the corresponding file:\n\nPlatformFileCLIlocalplatforms/local.mdnoneapple-notesplatforms/apple-notes.mdmemobearplatforms/bear.mdgrizzlyobsidianplatforms/obsidian.mdobsidian-clinotionplatforms/notion.mdcurl (API)evernoteplatforms/evernote.mdclinote"
      },
      {
        "title": "5. Unified Search Across Platforms",
        "body": "When searching notes:\n\nSearch local ~/notes/ first\nSearch each configured external platform\nCombine results with source indicators\n\nExample output:\n\nSearch: \"product roadmap\"\n\nLocal:\n  [[2026-02-19_product-sync]] - meeting, ~/notes/meetings/\n\nNotion:\n  \"Q1 Roadmap\" - page, Projects database\n\nBear:\n  \"Roadmap Ideas\" - #product #planning"
      },
      {
        "title": "6. Cross-Platform Action Tracking",
        "body": "~/notes/actions.md is the SINGLE source of truth for all action items, regardless of where the note lives.\n\nFormat includes source:\n\n| Task | Owner | Due | Source |\n|------|-------|-----|--------|\n| Review proposal | @alice | 2026-02-20 | local:[[2026-02-19_sync]] |\n| Update roadmap | @bob | 2026-02-22 | notion:Q1 Planning |\n| Draft post | @me | 2026-02-21 | bear:#content-ideas |"
      },
      {
        "title": "7. Filename Convention (Local)",
        "body": "For local notes: YYYY-MM-DD_topic-slug.md (date first, then topic)\n\nExternal platforms use their native naming/organization."
      },
      {
        "title": "Common Traps",
        "body": "Platform misconfiguration: Always verify platform is available before attempting. Fall back gracefully.\nVague deadlines: \"ASAP\", \"soon\", \"next week\" are not deadlines. Force explicit dates.\nMissing owners: \"We should do X\" needs \"@who will do X\"\nSplit action tracking: Never track actions only in the external platform. Always sync to central tracker.\nNo retrieval tags: A note without tags is a note you will never find."
      },
      {
        "title": "External Endpoints",
        "body": "EndpointData SentWhenPurposehttps://api.notion.com/v1/pagesNote title, contentUser configures NotionCreate pageshttps://api.notion.com/v1/databases/*/querySearch queriesUser searches Notion notesQuery database\n\nNo other external endpoints. Apple Notes, Bear, Obsidian, and Evernote use local CLI tools that communicate with locally-installed apps."
      },
      {
        "title": "Security & Privacy",
        "body": "Data flow by platform:\n\nLocal: All data stays in ~/notes/. No network.\nApple Notes: Data stays local. memo CLI communicates with Notes.app via macOS APIs.\nBear: Data stays local. grizzly CLI communicates with Bear.app.\nObsidian: Data stays local. obsidian-cli reads/writes vault files.\nNotion: Note content sent to api.notion.com. Requires user-provided API key.\nEvernote: Note content sent to Evernote servers via clinote. Requires user login.\n\nCredential handling:\n\nAgent asks permission before checking for credentials\nAgent never reads ~/.config/notion/api_key or ~/.config/grizzly/token without explicit user consent\nUser sets up credentials themselves via platform documentation\n\nWhat stays local always:\n\nAction items tracker: ~/notes/actions.md\nNote index: ~/notes/index.md\nPlatform config: ~/notes/config.md"
      },
      {
        "title": "Related Skills",
        "body": "Install with clawhub install <slug> if user confirms:\n\nmeetings — meeting facilitation and agendas\njournal — daily journaling practice\ndocumentation — technical docs"
      },
      {
        "title": "Feedback",
        "body": "If useful: clawhub star notes\nStay updated: clawhub sync"
      }
    ],
    "body": "Setup\n\nOn first use, read setup.md for platform selection and integration guidelines.\n\nWhen to Use\n\nUser 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.\n\nScope\n\nThis skill ONLY:\n\nCreates and manages markdown files in ~/notes/\nRuns user-installed CLI tools (memo, grizzly, obsidian-cli, clinote) if present and configured\nCalls Notion API only when user has configured Notion integration\nReads config from ~/notes/config.md to route notes to platforms\n\nThis skill NEVER:\n\nInstalls software automatically\nAccesses credential files without explicit user permission\nReads files outside ~/notes/ (except platform CLIs)\nSends data to external services unless user configures that platform\nModifies system settings or other applications\nPlatform Integrations (User-Installed, Optional)\n\nThis skill works 100% locally by default. External platforms require user to install tools separately:\n\nPlatform\tUser Installs\tUser Configures\tData Flow\nLocal\tnothing\tnothing\tAll local\nApple Notes\tmemo CLI\tnothing\tLocal (app communication)\nBear\tgrizzly CLI\tToken in ~/.config/grizzly/token\tLocal (app communication)\nObsidian\tobsidian-cli\tVault path\tLocal (file-based)\nNotion\tnothing\tAPI key\tNetwork (api.notion.com)\nEvernote\tclinote CLI\tLogin via CLI\tNetwork (Evernote servers)\n\nAgent behavior:\n\nAsks user which platforms they want before checking for tools\nOnly checks for CLI presence after user confirms interest\nFalls back to local if tool unavailable\nNever reads credential files without explicit permission per session\nArchitecture\n\nMemory at ~/notes/. See memory-template.md for setup.\n\n~/notes/\n├── config.md          # Platform routing configuration\n├── index.md           # Search index with tags\n├── meetings/          # Local meeting notes\n├── decisions/         # Local decision log\n├── projects/          # Local project notes\n├── journal/           # Local daily notes\n└── actions.md         # Central action tracker (all platforms)\n\nQuick Reference\nTopic\tFile\nSetup process\tsetup.md\nMemory template\tmemory-template.md\nAll note formats\tformats.md\nAction item system\ttracking.md\nLocal markdown\tplatforms/local.md\nApple Notes\tplatforms/apple-notes.md\nBear\tplatforms/bear.md\nObsidian\tplatforms/obsidian.md\nNotion\tplatforms/notion.md\nEvernote\tplatforms/evernote.md\nCore Rules\n1. Route to Configured Platform\n\nCheck ~/notes/config.md for platform routing:\n\n# Platform Routing\nmeetings: local          # or: apple-notes, bear, obsidian, notion\ndecisions: local\nprojects: notion\njournal: bear\nquick: apple-notes\n\n\nIf note type not configured, use local. If platform not available (missing CLI/credentials), fall back to local with warning.\n\n2. Always Use Structured Format\n\nEvery note type has a specific format regardless of platform. See formats.md for templates.\n\nNote Type\tTrigger\tKey Elements\nMeeting\t\"meeting notes\", \"call with\"\tAttendees, decisions, actions\nDecision\t\"we decided\", \"decision:\"\tContext, options, rationale\nBrainstorm\t\"ideas for\", \"brainstorm\"\tRaw ideas, clusters, next steps\nJournal\t\"daily note\", \"today I\"\tDate, highlights, blockers\nProject\t\"project update\", \"status\"\tProgress, blockers, next\nQuick\t\"note:\", \"remember\"\tMinimal format, tags\n3. Extract Action Items Aggressively\n\nIf someone says \"I'll do X\" or \"we need to Y\", that is an action item.\n\nEvery action item MUST have:\n\nOwner: Who is responsible (@name)\nTask: Specific, actionable description\nDeadline: Explicit date (not \"soon\" or \"ASAP\")\n\nAction items sync to ~/notes/actions.md regardless of which platform holds the note.\n\n4. Platform-Specific Execution\n\nAfter determining platform, read the corresponding file:\n\nPlatform\tFile\tCLI\nlocal\tplatforms/local.md\tnone\napple-notes\tplatforms/apple-notes.md\tmemo\nbear\tplatforms/bear.md\tgrizzly\nobsidian\tplatforms/obsidian.md\tobsidian-cli\nnotion\tplatforms/notion.md\tcurl (API)\nevernote\tplatforms/evernote.md\tclinote\n5. Unified Search Across Platforms\n\nWhen searching notes:\n\nSearch local ~/notes/ first\nSearch each configured external platform\nCombine results with source indicators\n\nExample output:\n\nSearch: \"product roadmap\"\n\nLocal:\n  [[2026-02-19_product-sync]] - meeting, ~/notes/meetings/\n\nNotion:\n  \"Q1 Roadmap\" - page, Projects database\n\nBear:\n  \"Roadmap Ideas\" - #product #planning\n\n6. Cross-Platform Action Tracking\n\n~/notes/actions.md is the SINGLE source of truth for all action items, regardless of where the note lives.\n\nFormat includes source:\n\n| Task | Owner | Due | Source |\n|------|-------|-----|--------|\n| Review proposal | @alice | 2026-02-20 | local:[[2026-02-19_sync]] |\n| Update roadmap | @bob | 2026-02-22 | notion:Q1 Planning |\n| Draft post | @me | 2026-02-21 | bear:#content-ideas |\n\n7. Filename Convention (Local)\n\nFor local notes: YYYY-MM-DD_topic-slug.md (date first, then topic)\n\nExternal platforms use their native naming/organization.\n\nCommon Traps\nPlatform misconfiguration: Always verify platform is available before attempting. Fall back gracefully.\nVague deadlines: \"ASAP\", \"soon\", \"next week\" are not deadlines. Force explicit dates.\nMissing owners: \"We should do X\" needs \"@who will do X\"\nSplit action tracking: Never track actions only in the external platform. Always sync to central tracker.\nNo retrieval tags: A note without tags is a note you will never find.\nExternal Endpoints\nEndpoint\tData Sent\tWhen\tPurpose\nhttps://api.notion.com/v1/pages\tNote title, content\tUser configures Notion\tCreate pages\nhttps://api.notion.com/v1/databases/*/query\tSearch queries\tUser searches Notion notes\tQuery database\n\nNo other external endpoints. Apple Notes, Bear, Obsidian, and Evernote use local CLI tools that communicate with locally-installed apps.\n\nSecurity & Privacy\n\nData flow by platform:\n\nLocal: All data stays in ~/notes/. No network.\nApple Notes: Data stays local. memo CLI communicates with Notes.app via macOS APIs.\nBear: Data stays local. grizzly CLI communicates with Bear.app.\nObsidian: Data stays local. obsidian-cli reads/writes vault files.\nNotion: Note content sent to api.notion.com. Requires user-provided API key.\nEvernote: Note content sent to Evernote servers via clinote. Requires user login.\n\nCredential handling:\n\nAgent asks permission before checking for credentials\nAgent never reads ~/.config/notion/api_key or ~/.config/grizzly/token without explicit user consent\nUser sets up credentials themselves via platform documentation\n\nWhat stays local always:\n\nAction items tracker: ~/notes/actions.md\nNote index: ~/notes/index.md\nPlatform config: ~/notes/config.md\nRelated Skills\n\nInstall with clawhub install <slug> if user confirms:\n\nmeetings — meeting facilitation and agendas\njournal — daily journaling practice\ndocumentation — technical docs\nFeedback\nIf useful: clawhub star notes\nStay updated: clawhub sync"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/notes",
    "publisherUrl": "https://clawhub.ai/ivangdavila/notes",
    "owner": "ivangdavila",
    "version": "1.1.3",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}