{
  "schemaVersion": "1.0",
  "item": {
    "slug": "notion-skill",
    "name": "Notion",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/Dimagious/notion-skill",
    "canonicalUrl": "https://clawhub.ai/Dimagious/notion-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/notion-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notion-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "notion-skill",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T12:21:51.661Z",
      "expiresAt": "2026-05-07T12:21:51.661Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notion-skill",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notion-skill",
        "contentDisposition": "attachment; filename=\"notion-skill-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "notion-skill"
      },
      "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/notion-skill"
    },
    "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/notion-skill",
    "agentPageUrl": "https://openagent3.xyz/skills/notion-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/notion-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/notion-skill/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Notion",
        "body": "This skill lets the agent work with Notion pages and databases using the official Notion API.\n\nThe skill is declarative: it documents safe, recommended operations and assumes a local CLI\n(notion-cli) that actually performs API calls."
      },
      {
        "title": "Authentication",
        "body": "Create a Notion Integration at https://www.notion.so/my-integrations\nCopy the Internal Integration Token.\nExport it as:\n\nexport NOTION_API_KEY=secret_xxx\n\nShare the integration with the pages or databases you want to access.\nUnshared content is invisible to the API."
      },
      {
        "title": "Profiles (personal / work)",
        "body": "You may define multiple profiles (e.g. personal, work) via env or config.\n\nDefault profile: personal\n\nOverride via:\n\nexport NOTION_PROFILE=work"
      },
      {
        "title": "Pages",
        "body": "Read page:\n\nnotion-cli page get <page_id>\n\nAppend blocks:\n\nnotion-cli block append <page_id> --markdown \"...\"\n\nPrefer appending over rewriting content.\n\nCreate page:\n\nnotion-cli page create --parent <page_id> --title \"...\""
      },
      {
        "title": "Databases",
        "body": "Inspect schema:\n\nnotion-cli db get <database_id>\n\nQuery database:\n\nnotion-cli db query <database_id> --filter <json> --sort <json>\n\nCreate row:\n\nnotion-cli page create --database <database_id> --props <json>\n\nUpdate row:\n\nnotion-cli page update <page_id> --props <json>"
      },
      {
        "title": "Schema changes (advanced)",
        "body": "Always inspect diffs before applying schema changes.\n\nNever modify database schema without explicit confirmation.\n\nRecommended flow:\n\nnotion-cli db schema diff <database_id> --desired <json>\nnotion-cli db schema apply <database_id> --desired <json>"
      },
      {
        "title": "Safety notes",
        "body": "Notion API is rate-limited; batch carefully.\nPrefer append and updates over destructive operations.\nIDs are opaque; store them explicitly, do not infer from URLs."
      }
    ],
    "body": "Notion\n\nThis skill lets the agent work with Notion pages and databases using the official Notion API.\n\nThe skill is declarative: it documents safe, recommended operations and assumes a local CLI (notion-cli) that actually performs API calls.\n\nAuthentication\nCreate a Notion Integration at https://www.notion.so/my-integrations\nCopy the Internal Integration Token.\nExport it as:\nexport NOTION_API_KEY=secret_xxx\n\n\nShare the integration with the pages or databases you want to access. Unshared content is invisible to the API.\n\nProfiles (personal / work)\n\nYou may define multiple profiles (e.g. personal, work) via env or config.\n\nDefault profile: personal\n\nOverride via:\n\nexport NOTION_PROFILE=work\n\nPages\n\nRead page:\n\nnotion-cli page get <page_id>\n\n\nAppend blocks:\n\nnotion-cli block append <page_id> --markdown \"...\"\n\n\nPrefer appending over rewriting content.\n\nCreate page:\n\nnotion-cli page create --parent <page_id> --title \"...\"\n\nDatabases\n\nInspect schema:\n\nnotion-cli db get <database_id>\n\n\nQuery database:\n\nnotion-cli db query <database_id> --filter <json> --sort <json>\n\n\nCreate row:\n\nnotion-cli page create --database <database_id> --props <json>\n\n\nUpdate row:\n\nnotion-cli page update <page_id> --props <json>\n\nSchema changes (advanced)\n\nAlways inspect diffs before applying schema changes.\n\nNever modify database schema without explicit confirmation.\n\nRecommended flow:\n\nnotion-cli db schema diff <database_id> --desired <json>\nnotion-cli db schema apply <database_id> --desired <json>\n\nSafety notes\nNotion API is rate-limited; batch carefully.\nPrefer append and updates over destructive operations.\nIDs are opaque; store them explicitly, do not infer from URLs."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Dimagious/notion-skill",
    "publisherUrl": "https://clawhub.ai/Dimagious/notion-skill",
    "owner": "Dimagious",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/notion-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/notion-skill",
    "agentUrl": "https://openagent3.xyz/skills/notion-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/notion-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/notion-skill/agent.md"
  }
}