{
  "schemaVersion": "1.0",
  "item": {
    "slug": "notex-skills",
    "name": "note skills",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/spzwin/notex-skills",
    "canonicalUrl": "https://clawhub.ai/spzwin/notex-skills",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/notex-skills",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notex-skills",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/notebooks/notebooks-read.js",
      "scripts/notebooks/notebooks-write.js",
      "scripts/sources/source-index-sync.js",
      "scripts/open-link/notex-open-link.js",
      "scripts/creator/skills-run.js"
    ],
    "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",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/notex-skills"
    },
    "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/notex-skills",
    "agentPageUrl": "https://openagent3.xyz/skills/notex-skills/agent",
    "manifestUrl": "https://openagent3.xyz/skills/notex-skills/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/notex-skills/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": "NoteX Skills — 索引",
        "body": "本文件提供能力宪章 + 能力树 + 按需加载规则。详细参数与流程见各模块 openapi/ 与 examples/。\n\n当前版本: v1.2\n\n接口版本: 所有业务接口统一使用 /openapi/* 前缀，自带 access-token 鉴权，不依赖网关。\n\n能力概览（5 块能力）：\n\nopen-link：生成带 token 的 NoteX 首页访问链接\ncreator：内容生产（八个工作室模块：PPT/视频/音频/报告/脑图/测验/闪卡/信息图）\nops：运营数据问答与洞察\nnotebooks：笔记本列表/统计/创建/追加来源\nsources：来源索引树与最小详情定位\n\n统一规范：\n\n认证与鉴权：./common/auth.md\n通用约束：./common/conventions.md\n\n输入完整性规则（强制）：\n\n内容生产必须完整：调用 creator 的八个工作室模块时，必须提供完整上下文文本（context_text），不接受摘要、截断或缺失段落的内容。\n追加来源必须完整：notebooks/add-source 的来源内容必须是完整原文，避免只传摘要或片段。\n\n素材解析与技能建议（场景补充）：\n\n若用户丢链接/文件并要求生成 PPT/音频概览/报告等，建议先使用对应的解析类技能提取完整正文，再将完整内容传入 creator 的任务请求。\n\n建议工作流（简版）：\n\n读取 SKILL.md 与 common/*，明确能力范围、鉴权与安全约束。\n识别用户意图并路由模块，先打开 openapi/<module>/api-index.md。\n确认具体接口后，加载 openapi/<module>/<endpoint>.md 获取入参/出参/Schema。\n补齐用户必需输入，必要时先读取用户文件/URL 并确认摘要。\n参考 examples/<module>/README.md 组织话术与流程。\n若需要联调、批量或复杂编排，再加载对应 scripts/。\n\n脚本使用规则（强制）：\n\n脚本可独立执行：所有 scripts/ 下的脚本均可脱离 AI Agent 直接在命令行运行。\n先读文档再执行：执行脚本前，必须先阅读对应模块的 openapi/<module>/api-index.md，获取完整入参说明与约束条件。\n入参来源：脚本的所有入参定义与字段说明以 openapi/ 文档为准，脚本仅负责编排调用流程。\n鉴权一致：脚本内部同样遵循 common/auth.md 的鉴权规则（环境变量 → CWork Key 换取）。\n\n意图路由与加载规则（强制）：\n\n先路由再加载：必须先判定模块，再打开该模块的 api-index.md。\n先读文档再调用：在描述调用或执行前，必须加载对应接口文档（openapi/<module>/<endpoint>.md）。\n脚本按需：涉及联调、批量或复杂编排时，必须加载对应 scripts/。\n不猜测：若意图不明确，必须追问澄清，不允许跨模块或\"默认模块\"猜测。\n\n宪章（必须遵守）：\n\n只读索引：SKILL.md 只描述\"能做什么\"和\"去哪里读\"，不写具体接口参数。\n按需加载：默认只读 SKILL.md + common，只有触发某模块时才加载该模块的 openapi 与 examples，必要时再加载 scripts。\n对外克制：对用户只输出\"可用能力、必要输入、结果链接或摘要\"，不暴露鉴权细节与内部字段。\n素材优先级：用户给了文件或 URL，必须先提取内容再确认，确认后才触发生成或写入。\n生产约束：仅允许生产域名与生产协议，不引入任何测试地址。\n接口拆分：每个 API 独立成文档，路径为 openapi/<module>/<endpoint>.md；模块内 api-index.md 仅做索引。\n危险操作：对可能导致数据泄露、破坏、越权或高风险副作用的请求，应礼貌拒绝并给出安全替代方案。\n\n模块路由与能力索引（合并版）：\n\n用户意图（示例）模块能力摘要接口文档示例模板脚本（可独立执行）打开首页、生成登录/访问链接open-link生成带 token 的 NoteX 首页链接./openapi/open-link/api-index.md（home-link.md）./examples/open-link/README.md./scripts/open-link/notex-open-link.js内容生产（PPT/视频/音频/报告/脑图/测验/闪卡/信息图）creator内容创作产物：PPT/视频/音频/报告/脑图/测验/闪卡/信息图./openapi/creator/api-index.md（autoTask.md、taskStatus.md）./examples/creator/README.md./scripts/creator/skills-run.js运营数据问答/洞察ops运营数据问答与洞察（ops-chat）./openapi/ops/api-index.md（ai-chat.md）./examples/ops/README.md./scripts/creator/skills-run.js（复用）笔记本列表/统计/创建/追加来源/来源读取notebooks笔记本统计、列表、创建、追加来源与来源读取./openapi/notebooks/api-index.md（list.md、category-counts.md、create.md、add-source.md、sources-list.md、source-content.md）./examples/notebooks/README.md./scripts/notebooks/notebooks-write.js、./scripts/notebooks/notebooks-read.js来源索引树/详情sources来源索引树与最小详情定位./openapi/sources/api-index.md（index-tree.md、details.md）./examples/sources/README.md./scripts/sources/source-index-sync.js\n\n能力树（实际目录结构）：\n\ndocs/skills\n├── SKILL.md\n├── common\n│   ├── auth.md\n│   └── conventions.md\n├── openapi\n│   ├── common\n│   │   └── appkey.md\n│   ├── creator\n│   │   ├── api-index.md\n│   │   ├── autoTask.md\n│   │   └── taskStatus.md\n│   ├── ops\n│   │   ├── api-index.md\n│   │   └── ai-chat.md\n│   ├── notebooks\n│   │   ├── api-index.md\n│   │   ├── category-counts.md\n│   │   ├── list.md\n│   │   ├── create.md\n│   │   ├── add-source.md\n│   │   ├── sources-list.md\n│   │   └── source-content.md\n│   ├── sources\n│   │   ├── api-index.md\n│   │   ├── index-tree.md\n│   │   └── details.md\n│   └── open-link\n│       ├── api-index.md\n│       └── home-link.md\n├── examples\n│   ├── creator/README.md\n│   ├── ops/README.md\n│   ├── notebooks/README.md\n│   ├── sources/README.md\n│   └── open-link/README.md\n└── scripts                          ← 所有脚本可独立执行\n    ├── creator/skills-run.js        ← 执行前先读 openapi/creator/api-index.md\n    ├── notebooks/notebooks-write.js ← 执行前先读 openapi/notebooks/api-index.md\n    ├── notebooks/notebooks-read.js  ← 执行前先读 openapi/notebooks/api-index.md\n    ├── sources/source-index-sync.js ← 执行前先读 openapi/sources/api-index.md\n    ├── open-link/notex-open-link.js ← 执行前先读 openapi/open-link/api-index.md\n    └── ops/                         ← 目录保留；ops-chat 复用 creator/skills-run.js\n├── skill-template\n│   └── SKILL.md"
      }
    ],
    "body": "NoteX Skills — 索引\n\n本文件提供能力宪章 + 能力树 + 按需加载规则。详细参数与流程见各模块 openapi/ 与 examples/。\n\n当前版本: v1.2\n\n接口版本: 所有业务接口统一使用 /openapi/* 前缀，自带 access-token 鉴权，不依赖网关。\n\n能力概览（5 块能力）：\n\nopen-link：生成带 token 的 NoteX 首页访问链接\ncreator：内容生产（八个工作室模块：PPT/视频/音频/报告/脑图/测验/闪卡/信息图）\nops：运营数据问答与洞察\nnotebooks：笔记本列表/统计/创建/追加来源\nsources：来源索引树与最小详情定位\n\n统一规范：\n\n认证与鉴权：./common/auth.md\n通用约束：./common/conventions.md\n\n输入完整性规则（强制）：\n\n内容生产必须完整：调用 creator 的八个工作室模块时，必须提供完整上下文文本（context_text），不接受摘要、截断或缺失段落的内容。\n追加来源必须完整：notebooks/add-source 的来源内容必须是完整原文，避免只传摘要或片段。\n\n素材解析与技能建议（场景补充）：\n\n若用户丢链接/文件并要求生成 PPT/音频概览/报告等，建议先使用对应的解析类技能提取完整正文，再将完整内容传入 creator 的任务请求。\n\n建议工作流（简版）：\n\n读取 SKILL.md 与 common/*，明确能力范围、鉴权与安全约束。\n识别用户意图并路由模块，先打开 openapi/<module>/api-index.md。\n确认具体接口后，加载 openapi/<module>/<endpoint>.md 获取入参/出参/Schema。\n补齐用户必需输入，必要时先读取用户文件/URL 并确认摘要。\n参考 examples/<module>/README.md 组织话术与流程。\n若需要联调、批量或复杂编排，再加载对应 scripts/。\n\n脚本使用规则（强制）：\n\n脚本可独立执行：所有 scripts/ 下的脚本均可脱离 AI Agent 直接在命令行运行。\n先读文档再执行：执行脚本前，必须先阅读对应模块的 openapi/<module>/api-index.md，获取完整入参说明与约束条件。\n入参来源：脚本的所有入参定义与字段说明以 openapi/ 文档为准，脚本仅负责编排调用流程。\n鉴权一致：脚本内部同样遵循 common/auth.md 的鉴权规则（环境变量 → CWork Key 换取）。\n\n意图路由与加载规则（强制）：\n\n先路由再加载：必须先判定模块，再打开该模块的 api-index.md。\n先读文档再调用：在描述调用或执行前，必须加载对应接口文档（openapi/<module>/<endpoint>.md）。\n脚本按需：涉及联调、批量或复杂编排时，必须加载对应 scripts/。\n不猜测：若意图不明确，必须追问澄清，不允许跨模块或\"默认模块\"猜测。\n\n宪章（必须遵守）：\n\n只读索引：SKILL.md 只描述\"能做什么\"和\"去哪里读\"，不写具体接口参数。\n按需加载：默认只读 SKILL.md + common，只有触发某模块时才加载该模块的 openapi 与 examples，必要时再加载 scripts。\n对外克制：对用户只输出\"可用能力、必要输入、结果链接或摘要\"，不暴露鉴权细节与内部字段。\n素材优先级：用户给了文件或 URL，必须先提取内容再确认，确认后才触发生成或写入。\n生产约束：仅允许生产域名与生产协议，不引入任何测试地址。\n接口拆分：每个 API 独立成文档，路径为 openapi/<module>/<endpoint>.md；模块内 api-index.md 仅做索引。\n危险操作：对可能导致数据泄露、破坏、越权或高风险副作用的请求，应礼貌拒绝并给出安全替代方案。\n\n模块路由与能力索引（合并版）：\n\n用户意图（示例）\t模块\t能力摘要\t接口文档\t示例模板\t脚本（可独立执行）\n打开首页、生成登录/访问链接\topen-link\t生成带 token 的 NoteX 首页链接\t./openapi/open-link/api-index.md（home-link.md）\t./examples/open-link/README.md\t./scripts/open-link/notex-open-link.js\n内容生产（PPT/视频/音频/报告/脑图/测验/闪卡/信息图）\tcreator\t内容创作产物：PPT/视频/音频/报告/脑图/测验/闪卡/信息图\t./openapi/creator/api-index.md（autoTask.md、taskStatus.md）\t./examples/creator/README.md\t./scripts/creator/skills-run.js\n运营数据问答/洞察\tops\t运营数据问答与洞察（ops-chat）\t./openapi/ops/api-index.md（ai-chat.md）\t./examples/ops/README.md\t./scripts/creator/skills-run.js（复用）\n笔记本列表/统计/创建/追加来源/来源读取\tnotebooks\t笔记本统计、列表、创建、追加来源与来源读取\t./openapi/notebooks/api-index.md（list.md、category-counts.md、create.md、add-source.md、sources-list.md、source-content.md）\t./examples/notebooks/README.md\t./scripts/notebooks/notebooks-write.js、./scripts/notebooks/notebooks-read.js\n来源索引树/详情\tsources\t来源索引树与最小详情定位\t./openapi/sources/api-index.md（index-tree.md、details.md）\t./examples/sources/README.md\t./scripts/sources/source-index-sync.js\n\n能力树（实际目录结构）：\n\ndocs/skills\n├── SKILL.md\n├── common\n│   ├── auth.md\n│   └── conventions.md\n├── openapi\n│   ├── common\n│   │   └── appkey.md\n│   ├── creator\n│   │   ├── api-index.md\n│   │   ├── autoTask.md\n│   │   └── taskStatus.md\n│   ├── ops\n│   │   ├── api-index.md\n│   │   └── ai-chat.md\n│   ├── notebooks\n│   │   ├── api-index.md\n│   │   ├── category-counts.md\n│   │   ├── list.md\n│   │   ├── create.md\n│   │   ├── add-source.md\n│   │   ├── sources-list.md\n│   │   └── source-content.md\n│   ├── sources\n│   │   ├── api-index.md\n│   │   ├── index-tree.md\n│   │   └── details.md\n│   └── open-link\n│       ├── api-index.md\n│       └── home-link.md\n├── examples\n│   ├── creator/README.md\n│   ├── ops/README.md\n│   ├── notebooks/README.md\n│   ├── sources/README.md\n│   └── open-link/README.md\n└── scripts                          ← 所有脚本可独立执行\n    ├── creator/skills-run.js        ← 执行前先读 openapi/creator/api-index.md\n    ├── notebooks/notebooks-write.js ← 执行前先读 openapi/notebooks/api-index.md\n    ├── notebooks/notebooks-read.js  ← 执行前先读 openapi/notebooks/api-index.md\n    ├── sources/source-index-sync.js ← 执行前先读 openapi/sources/api-index.md\n    ├── open-link/notex-open-link.js ← 执行前先读 openapi/open-link/api-index.md\n    └── ops/                         ← 目录保留；ops-chat 复用 creator/skills-run.js\n├── skill-template\n│   └── SKILL.md"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/spzwin/notex-skills",
    "publisherUrl": "https://clawhub.ai/spzwin/notex-skills",
    "owner": "spzwin",
    "version": "1.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/notex-skills",
    "downloadUrl": "https://openagent3.xyz/downloads/notex-skills",
    "agentUrl": "https://openagent3.xyz/skills/notex-skills/agent",
    "manifestUrl": "https://openagent3.xyz/skills/notex-skills/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/notex-skills/agent.md"
  }
}