Agent skill

Getnote

by iswalle in iswalle/getnote-openclaw

通过官方 getnote CLI 连接得到大脑,完成浏览器授权、连接诊断、CLI 升级,以及保存、查询、搜索和管理真实笔记。用户要保存链接/图片、上传文件到知识库、查询文件限制、读取标记/发芽报告/时间线、整理知识库/文件夹、订阅博主、管理标签,或明确要求登录、诊断或升级时使用;不会自行安装或更新 Skill。

MITAuto-check passed

Install Getnote

skills CLI
$ npx skills add iswalle/getnote-openclaw --skill getnote -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install iswalle/getnote-openclaw getnote --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
getnote
GitHub stars
137
Token cost
~1.1k tokens
SKILL.md length
251 words
Files
14 (incl. scripts, references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

通过官方 getnote CLI 连接得到大脑,完成浏览器授权、连接诊断、CLI 升级,以及保存、查询、搜索和管理真实笔记。用户要保存链接/图片、上传文件到知识库、查询文件限制、读取标记/发芽报告/时间线、整理知识库/文件夹、订阅博主、管理标签,或明确要求登录、诊断或升级时使用;不会自行安装或更新 Skill。

  • Works in 5 steps: 执行 command -v getnote。如果 CLI 不存在,调用平台根据… → 执行 getnote setup,让 CLI 检测本机 AI、同步五个领域… → 尚未授权时运行 getnote auth login… → …
  • SKILL.md covers 能力与外部影响, 能力概览, 首次连接 and 每次任务的执行闭环, plus 5 more sections
  • Runs Python scripts from its folder

What it does

Getnote is an agent skill from iswalle/getnote-openclaw. 通过官方 getnote CLI 连接得到大脑,完成浏览器授权、连接诊断、CLI 升级,以及保存、查询、搜索和管理真实笔记。用户要保存链接/图片、上传文件到知识库、查询文件限制、读取标记/发芽报告/时间线、整理知识库/文件夹、订阅博主、管理标签,或明确要求登录、诊断或升级时使用;不会自行安装或更新 Skill。

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 17 other files, including scripts and reference files (for example `.github/workflows/release-skill-package.yml`, `.github/workflows/validate.yml` and `README.md`).

The repository describes itself as: Get 笔记 openclaw Skill. The licence is MIT.

Example prompts

  • “/getnote”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 执行 command -v getnote。如果 CLI 不存在,调用平台根据 frontmatter install 声明提供的 @getnote/cli 安装流程;不要让用户选择安装方式,也不要查找本地安装脚本。
  2. 执行 getnote setup,让 CLI 检测本机 AI、同步五个领域 Skill 并引导授权。当前独立 Skill 仍由平台管理,CLI 不覆盖它。
  3. 尚未授权时运行 getnote auth login 并让用户只在浏览器确认;不得索要 API Key、Cookie 或 Authorization。
  4. 执行 getnote doctor -o json。只有命令退出码为 0、diagnostics_completed=true 且 ready=true,才能说已经连接;status=degraded 时继续说明并处理非阻断警告。
  5. 先运行 getnote notes --limit 1 -o json 做无写入验收。只有用户同意时才保存测试笔记,而且必须返回真实标题、字符串笔记 ID 和可打开的 note_url 才算完成。

What it can do on your machine

Read from SKILL.md and the folder at commit 7bed8e9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Getnote loads about 1.1k tokens when it runs, and up to ~8.7k if it reads all its reference files. Until then it costs about 41 tokens; SKILL.md has 251 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from iswalle/getnote-openclaw at commit 7bed8e9, republished under its MIT licence (© iswalle). 251 words, ~1,053 tokens.

Download SKILL.mdSave it as .claude/skills/getnote/SKILL.md (or your agent's skills folder). This skill also uses 13 other files; get the full folder from GitHub.
name
getnote
description
通过官方 getnote CLI 连接得到大脑,完成浏览器授权、连接诊断、CLI 升级,以及保存、查询、搜索和管理真实笔记。用户要保存链接/图片、上传文件到知识库、查询文件限制、读取标记/发芽报告/时间线、整理知识库/文件夹、订阅博主、管理标签,或明确要求登录、诊断或升级时使用;不会自行安装或更新 Skill。
version
2.1.0

得到大脑(原 Get 笔记)

让用户在当前 AI 中直接连接、诊断、升级 CLI,以及保存、查找和整理自己的得到大脑内容。本 Skill 理解用户意图、加载对应领域参考,并交给官方 getnote CLI 执行真实操作。

能力与外部影响

  • 本 Skill 会按用户请求执行 getnote 命令,并通过得到大脑官方 API 读取或修改当前已授权账号的数据。
  • 登录会打开浏览器授权页,并由 CLI 把授权信息保存在其本机配置目录;Skill 不读取、展示或转发完整凭证。
  • 保存、更新、归档、分享和删除会修改远端笔记数据,并遵守下方的确认规则。
  • 只有用户明确要求升级时才执行 getnote update;不会自行运行 npm、安装其他软件、下载并覆盖本 Skill 或修改其他 Skill 文件。
  • getnote 缺失时使用平台根据 frontmatter install 声明提供的官方安装流程;平台要求确认时只请求这一次确认,不查找或运行 scripts/install.sh。

能力概览

用户想做什么典型说法完成后应返回什么
保存内容“记一下”“保存这个链接”“把这张图存起来”真实标题、字符串笔记 ID、可打开的笔记链接;异步内容必须等生成完成
查找内容“最近记了什么”“帮我找客户反馈”按相关度或时间排列的真实标题、摘要和链接
深入阅读“打开这条笔记”“看录音原文”“有哪些会议待办”用户点名的详情视图,不用总结代替原文
整理知识“放进产品研究的竞品文件夹”真实知识库、目录和归档结果;写后复读验证
管理内容“加标签”“更新正文”“分享或删除”最终状态;危险操作先确认
连接与排障“登录得到大脑”“检查为什么不能用”“更新到最新版”CLI、授权和 API 的实际检查结果及下一步

不要要求用户记命令。用户用自然语言表达目标即可。

首次连接

文件上传、标记、发芽报告和章节时间线需要官方 CLI 1.6.0 或更新版本;缺少命令时告知用户升级,不以其它数据代替。

例外:用户已授权云 MCP、只需要本地上传文件时,安装 CLI 后仅执行 getnote upload,不运行 setup、auth login 或要求第二次身份授权。按 references/kb.md 的直传流程完成;无需上传文件时继续使用云 MCP。

  1. 执行 command -v getnote。如果 CLI 不存在,调用平台根据 frontmatter install 声明提供的 @getnote/cli 安装流程;不要让用户选择安装方式,也不要查找本地安装脚本。
  2. 执行 getnote setup,让 CLI 检测本机 AI、同步五个领域 Skill 并引导授权。当前独立 Skill 仍由平台管理,CLI 不覆盖它。
  3. 尚未授权时运行 getnote auth login 并让用户只在浏览器确认;不得索要 API Key、Cookie 或 Authorization。
  4. 执行 getnote doctor -o json。只有命令退出码为 0、diagnostics_completed=true 且 ready=true,才能说已经连接;status=degraded 时继续说明并处理非阻断警告。
  5. 先运行 getnote notes --limit 1 -o json 做无写入验收。只有用户同意时才保存测试笔记,而且必须返回真实标题、字符串笔记 ID 和可打开的 note_url 才算完成。

每次任务的执行闭环

  1. 理解目标:识别用户要处理的对象、动作和目标位置;“这条笔记”“这个博主”等指代不明确时先澄清。
  2. 加载领域参考:只读取本次任务涉及的 references/*.md,不要凭印象猜命令、参数或返回字段。
  3. 确认真实对象:先读取笔记、知识库、文件夹或标签的真实字符串 ID。名称重名时让用户选择。
  4. 执行官方 CLI:机器调用加 -o json;长内容使用领域参考规定的文件或标准输入方式。
  5. 判断结果:同时检查退出码、success 和领域结果字段。异步任务轮询到最终状态,不能把“已提交”说成“已完成”。
  6. 必要时复读:归档、更新、删除标签等操作按领域参考重新读取结果,确认服务端最终状态。
  7. 回复用户:先给结论,再给标题、链接或必要摘要;失败时说明原因、是否可重试、下一步和 request_id。

路由

匹配用户意图后,必须读取并遵循对应领域参考:

一个任务涉及多个领域时,按实际步骤依次读取对应参考。例如“找到最近的客户反馈并放进客户档案”先读搜索,再读知识库。

结果呈现标准

  • 保存成功:回复标题、字符串 note_id 和真实 note_url。链接或图片仍在生成时持续等待;超时则明确说仍在处理,不伪造完成。
  • 笔记列表与搜索:每条至少包含标题和真实链接;有摘要时简短展示。相同 note_id 的多个命中片段按领域参考去重。
  • 笔记详情:按用户点名的视图展示标题、总结、原文、录音转写、附件、时间线、快捷笔记或会议待办,不用其他字段冒充。
  • 知识库与目录:展示真实名称、Scope 和字符串 ID;归档完成后说明笔记进入了哪个知识库及目录。
  • 更新、分享与删除:明确最终状态和影响范围。取消或权限不足不能回复成功。
  • 空结果:说明没有找到以及实际搜索范围,可建议换关键词、时间或知识库,但不能编造候选项。
  • 失败:用用户能理解的话解释,并保留错误码和 request_id 供排查;敏感凭证不得出现在回复中。

统一规则

  • 所有真实操作由官方 getnote CLI 完成;参数不确定时读取对应命令 --help,机器调用统一加 -o json。
  • 退出码非 0 一律是失败。成功结果读取 success=true 和领域 Skill 指定的 data 字段;失败结果读取 error.code/message/reason/retryable 和可选 request_id,不能根据自然语言猜成功。
  • ID 始终按字符串原样传递;链接只使用真实返回值,不自行拼接域名。
  • 写操作结果不确定时先查询原任务或最近结果,禁止盲目重复创建。
  • 删除、覆盖、替换全部标签、公开分享和批量移出必须先确认。
  • 群聊或共享会话中不主动展开私密全文,先确认请求者和展示范围。
  • 失败时说明真实原因、是否可重试和下一步,并保留 request_id;不能伪造成功。

常见恢复方式

  • unauthorized 或授权过期:读 references/auth.md,引导浏览器重新授权,不索取凭证。
  • forbidden:说明当前账号或团队角色没有权限,不绕过权限或换 ID 猜测。
  • not_found:重新解析真实笔记、知识库或目录 ID;环境不同的链接和 ID 不能混用。
  • conflict:先读取当前版本或既有目录,避免覆盖和重复创建。
  • rate_limited:按返回的重试提示等待,不高频循环调用。
  • 网络中断或结果不确定:只做查询核验,不自动重复写入。

用户要求更新

用户说“更新得到大脑”已经构成完整更新授权,不再让用户选择内部组件:

  1. 按 references/auth.md 执行 getnote update,升级 CLI、同步 CLI 随附的五个领域 Skill 并完成诊断。
  2. 使用 ClawHub/OpenClaw 的宿主流程检查并更新当前独立 Skill;平台需要用户确认时,只提供唯一必要的确认动作。
  3. 本 Skill 不通过 CLI、npm 或下载脚本覆盖自身文件。

© iswalle, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 13 other files (scripts, references) in the repository root of iswalle/getnote-openclaw.

  • SKILL.md
  • .clawhubignore
  • .github/workflows/release-skill-package.yml
  • .github/workflows/validate.yml
  • .gitignore
  • LICENSE
  • README.md
  • references/auth.md
  • references/kb.md
  • references/note.md
  • references/search.md
  • references/tag.md
  • scripts/build_skill_package.py
  • scripts/verify_cli_contract.py

Open the folder on GitHubat commit 7bed8e9

Compare with similar skills

Getnote next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Getnote compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Getnote this skilliswalle/getnote-openclaw137—~1.1kAutomated safety check: PassMIT
Getnote Searchiswalle/getnote-cli178—~535Automated safety check: PassMIT
Getnote Tagiswalle/getnote-cli178—~400Automated safety check: PassMIT
Getnote Authiswalle/getnote-cli178—~1.1kAutomated safety check: PassMIT
Getnote Noteiswalle/getnote-cli178—~1.2kAutomated safety check: PassMIT
Getnote Kbiswalle/getnote-cli178—~1.7kAutomated safety check: PassMIT

Similar skills

  • Getnote Search

    iswalle/getnote-cli

    在得到大脑的全部笔记或指定知识库中按自然语言进行语义搜索,返回真实标题、摘要、字符串 ID 和可打开的笔记链接. An agent skill from iswalle/getnote-cli.

    178 GitHub stars~535 tokensUpdated 14 days ago
    Auto-check passed
  • Getnote Tag

    iswalle/getnote-cli

    查看得到大脑笔记已有标签,为笔记添加标签,或按真实标签 ID 安全删除标签,并避免误删系统标签或覆盖其他标签. An agent skill from iswalle/getnote-cli.

    178 GitHub stars~400 tokensUpdated 14 days ago
    Auto-check passed
  • Getnote Auth

    iswalle/getnote-cli

    安装和连接得到大脑,完成浏览器授权、环境诊断、配额检查、CLI 升级与领域 Skill 同步。用户说“安装/连接/登录/更新得到大脑”“检查为什么不能用”“查看额度”时使用。

    178 GitHub stars~1.1k tokensUpdated 14 days ago
    Auto-check passed
  • Getnote Note

    iswalle/getnote-cli

    使用得到大脑保存文字、链接、图片和长笔记,查看笔记详情、原文、录音转写、附件、时间线、标记、发芽报告、快捷笔记和会议待办,并安全更新、删除或分享笔记。标记、发芽与时间线分别读取。

    178 GitHub stars~1.2k tokensUpdated 14 days ago
    Auto-check passed
  • Getnote Kb

    iswalle/getnote-cli

    查看和管理得到大脑的知识库、文件夹、书籍、客户档案、团队知识库、抖音博主订阅与直播,归档笔记,以及查询文件格式限制、直传文件到 OSS 并提交知识库入库。用户要上传文档或文件时也使用。

    178 GitHub stars~1.7k tokensUpdated 14 days ago
    Auto-check passed

Questions about Getnote

What does Getnote do?

通过官方 getnote CLI 连接得到大脑,完成浏览器授权、连接诊断、CLI 升级,以及保存、查询、搜索和管理真实笔记。用户要保存链接/图片、上传文件到知识库、查询文件限制、读取标记/发芽报告/时间线、整理知识库/文件夹、订阅博主、管理标签,或明确要求登录、诊断或升级时使用;不会自行安装或更新 Skill。. Getnote is an agent skill from iswalle/getnote-openclaw.

How do I install Getnote in Claude Code?

Run `npx skills add iswalle/getnote-openclaw --skill getnote -a claude-code`. Or copy the skill folder (the iswalle/getnote-openclaw repository) into .claude/skills/getnote in your project. Claude Code loads it when a task matches its description.

How do I install Getnote in Codex?

Run `npx skills add iswalle/getnote-openclaw --skill getnote -a codex`. Or copy the skill folder (the iswalle/getnote-openclaw repository) into .agents/skills/getnote in your project. Codex loads it when a task matches its description.

Can I use Getnote in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add iswalle/getnote-openclaw --skill getnote -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/getnote, .gemini/skills/getnote, .github/skills/getnote and .opencode/skills/getnote in your project.

What does Getnote need to run?

Going by SKILL.md and its folder, Getnote needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Getnote access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Getnote safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Getnote use?

Getnote is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Getnote use?

About 1.1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.6k tokens, read only when the agent opens those files.

What are the alternatives to Getnote?

Skills that share tags, products or a category with Getnote: Getnote Search (iswalle/getnote-cli, 178 stars), Getnote Tag (iswalle/getnote-cli, 178 stars), Getnote Auth (iswalle/getnote-cli, 178 stars) and Getnote Note (iswalle/getnote-cli, 178 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Getnote?

iswalle (a GitHub user) maintains it in iswalle/getnote-openclaw, which has 137 GitHub stars. The repository was last updated on September 24, 2026.

Source: iswalle/getnote-openclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.