Agent skill

Getnote Note

by iswalle in iswalle/getnote-cli

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

MITAuto-check passed

Install Getnote Note

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

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

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

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

Manual copy
$ git clone --depth 1 https://github.com/iswalle/getnote-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/getnote-note .claude/skills/getnote-note && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

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

Facts

Skill name
getnote-note
GitHub stars
178
Token cost
~1.2k tokens
SKILL.md length
391 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 4 steps: 保留用户原意,不擅自扩写;未指定时不添加知识库、父笔记、标签或公开分享。 → 短文本可作为参数传入。长文本、Markdown、含复杂引号或换行的内容必须使用… → 重试同一次创建时复用同一个 --idempotency-key。 → …
  • SKILL.md covers 统一结果判定, 意图路由, 保存流程 and 查询和深层读取, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

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

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Get笔记 CLI — 让人类和 AI Agent 都能在终端操作 Get笔记. The licence is MIT.

Example prompts

  • “/getnote-note”

Workflow steps

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

  1. 保留用户原意,不擅自扩写;未指定时不添加知识库、父笔记、标签或公开分享。
  2. 短文本可作为参数传入。长文本、Markdown、含复杂引号或换行的内容必须使用 --content-file 或 --stdin,避免截断和转义损坏。
  3. 重试同一次创建时复用同一个 --idempotency-key。
  4. 只有命令退出码为 0,且最终结构中存在非空字符串 data.note.note_id、data.note.title、data.note.note_url,才回复保存成功。

What it can do on your machine

Read from SKILL.md and the folder at commit 98275f0. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    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 Note loads about 1.2k tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 391 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from iswalle/getnote-cli at commit 98275f0, republished under its MIT licence (© iswalle). 391 words, ~1,236 tokens.

Download SKILL.mdSave it as .claude/skills/getnote-note/SKILL.md (or your agent's skills folder).
name
getnote-note
description
使用得到大脑保存文字、链接、图片和长笔记,查看笔记详情、原文、录音转写、附件、时间线、标记、发芽报告、快捷笔记和会议待办,并安全更新、删除或分享笔记。标记、发芽与时间线分别读取。

得到大脑笔记

通过官方 getnote CLI 完成真实操作。不要自己拼 OpenAPI 请求、ID 或笔记链接;机器调用优先使用 -o json,以退出码和下述结果契约判断结果。

统一结果判定

所有 API 命令的 JSON 结果先看下面这层结构,再读取每条命令规定的 data 字段:

json
{
  "success": true,
  "data": {},
  "request_id": "可选"
}

失败结果为 success=false 或命令退出码非 0,读取 error.code、error.message、error.reason、error.retryable 和可选 request_id。HTTP 成功、上传完成、出现任务 ID 或拿到空笔记链接,都不能替代最终成功结果。

意图路由

意图命令入口
保存文字、链接或本地图片getnote save
查询异步保存任务getnote task
查看最近笔记getnote notes
查看详情或字段getnote note
链接/文字原文getnote note original
录音、会议或课堂转写getnote note transcript
图片、音频和文件附件getnote note attachments
录音或会议时间线getnote note timeline
总结中的章节时间线getnote note chapters
录音笔记标记(独立数据)getnote marks <note_id>
按月列出发芽报告getnote sprouts <YYYY-MM>
读取发芽报告原文getnote sprout <id>
录音快捷笔记gnote note quick,旧版回退 getnote note quick-note
会议总结中的派生待办getnote note todos
修改笔记getnote note update
删除笔记getnote note delete
公开分享getnote note share

不确定参数时先运行目标命令 --help。

保存流程

文字与长文
  1. 保留用户原意,不擅自扩写;未指定时不添加知识库、父笔记、标签或公开分享。
  2. 短文本可作为参数传入。长文本、Markdown、含复杂引号或换行的内容必须使用 --content-file 或 --stdin,避免截断和转义损坏。
  3. 重试同一次创建时复用同一个 --idempotency-key。
  4. 只有命令退出码为 0,且最终结构中存在非空字符串 data.note.note_id、data.note.title、data.note.note_url,才回复保存成功。
链接
  1. 以 http:// 或 https:// 开头且用户表达保存意图时按链接保存,不当作普通文字。
  2. CLI 会轮询异步任务。处理中可以告诉用户“正在抓取并生成笔记”,但不能提前给出成功结论。
  3. 最终成功必须满足文字保存的三项字段,并且 data.note 已能读取;不要自行拼接链接。
图片
  1. 使用本轮用户明确给出的本地图片路径,不把文件名保存成文字,也不带上历史图片。
  2. CLI 会校验真实文件格式、上传图片并轮询识别任务。
  3. 只有最终笔记详情返回有效 note_id/title/note_url 才算成功;“图片已上传”不是“笔记已生成”。
异步超时与安全重试
  • getnote save ... -o json 正常会等待最终结果;若退出码非 0 且输出含 task_id、status=pending|processing,操作结果仍不确定。
  • 结果不确定时使用 getnote task <task_id> -o json 查询原任务。done|success 且有有效 note_id 后再读取笔记;failed 时展示 error_msg 或 msg。
  • 超时、断流或网络错误后禁止直接再次保存;先查询原任务或最近笔记。只有 CLI/API 明确 retryable=true 且已确认原操作没有成功时才重试。

查询和深层读取

  1. “最近、列表、有哪些”使用 getnote notes;“找、搜、关于某主题”交给搜索 Skill。
  2. 用户给出 ID 时直接读取详情;雪花 ID 全程按字符串原样传递。“这条笔记”只复用当前会话中已经由 CLI 返回并验证过的字符串 ID。当前 CLI 若不能直接接收某种私有链接,就先请用户提供 ID,不能自行截取、猜测或转成数字。
  3. 列表先展示标题、字符串 ID 和真实 note_url,用户选择后再读取全文。
  4. 不确定笔记类型时先读 getnote note <id> -o json:
    • 链接/文字原文:original;
    • 录音、会议、课堂逐字稿:transcript;
    • 图片、音频、文件:attachments;
    • 章节时间点与会议过程:chapters,读取 chapter_timeline.items,保留规则解析来源 source;录音 moments 使用 timeline,两者不是同一份数据;
    • 用户现场快捷记录:quick-note;
    • 会议待办:todos,必须保留 source,不得把规则解析结果说成上游原生待办。
  5. 不拿 content 中的 AI 摘要冒充原文。
  6. 标记从 getnote marks 的 data.marks[] 读取,不使用 Timeline 的条数或内容替代。发芽从 getnote sprouts 列出报告,再用 getnote sprout 读取正文;has_sprout=false 如实表示没有可读报告,不把标记或笔记总结当作发芽。
Show full SKILL.md (159 more words)Show less

修改、删除和分享

  1. 先读取目标笔记和当前版本,确认用户指向的对象。
  2. 追加或前置内容必须使用 CLI 当前帮助中对应的增量语义,不用覆盖模拟追加。
  3. 覆盖正文、替换全部标签、删除和公开分享必须先确认;确认后才使用 --yes。
  4. 分享录音类笔记时,确认话术必须说明公开链接是否包含音频;用户不希望公开音频时使用 CLI 帮助中的 --exclude-audio。不能替用户默认决定音频公开范围。
  5. 用户未要求公开时只返回私有 note_url,不自动生成分享链接。

每条命令的结果与回复格式

命令成功结果必须包含回复规则
getnote save … -o jsonsuccess=true、data.note.note_id/title/note_url回复“已保存《标题》”和真实链接。链接/图片先只得到 task_id 时还未成功,继续查任务。
getnote task <task_id> -o jsondata.task_id/status/note_id?/msg?/error_msg?仅 done/success 且有 note_id 为完成;pending/processing 是处理中;failed 说明真实原因。
getnote notes -o jsondata.notes[].note_id/title/note_url、has_more/cursor/total返回标题、字符串 ID 和真实链接;下一页只用返回的 cursor。
getnote note <id> -o jsondata.note.note_id/title/note_url/note_type,按需读 content先给摘要和链接;私密全文只在用户明确要求时展开。
getnote note original <id> -o jsondata.note_id/title/original只把 original 当原文;空字段就是该笔记没有可用原文。
getnote note transcript <id> -o jsondata.note_id/title/transcript仅录音类笔记可用;不可用时如实说明。
getnote note attachments <id> -o jsondata.note_id/title/attachments[]列出真实附件,不把笔记封面冒充附件。
getnote note timeline <id> -o jsondata.note_id/title/timeline仅在存在录音/会议时间线时展示。
getnote note chapters <id> -o jsondata.note_id/title/chapter_timelineitems[].start_ms 为毫秒;空数组表示无可解析章节,不拿标记补齐。
gnote note quick <id> -o jsondata.note_id/title/quick_note返回现场快捷笔记;旧环境回退 getnote note quick-note。
getnote note todos <id> -o jsondata.note_id/title/meeting_todos[]保留每项 source;这是从明确会议总结章节按规则解析,不说成上游原生待办。
getnote note update <id> … -o jsonsuccess=true、data?修改正文或全量标签前必须 --yes;需要展示最终内容时再读一次 note。
getnote note delete <id> --yes -o jsonsuccess=true、data?只能说“已移入回收站”,不是永久删除。
getnote note share <id> --yes -o jsonsuccess=true、data.note_id/share_id/share_url只返回真实 share_url,并明确其为公开链接。

API 失败时回复失败步骤、error.message/reason、是否可重试和 request_id;不能把 HTTP 200 当业务成功。

群聊或共享会话中只先展示必要标题和链接,不主动展开私密全文。

© 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

Just SKILL.md in skills/getnote-note of iswalle/getnote-cli.

Open the folder on GitHubat commit 98275f0

Compare with similar skills

Getnote Note 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 Note compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Getnote Note this skilliswalle/getnote-cli178—~1.2kAutomated safety check: PassMIT
Meeting Notesoutline/outline41k—~551Automated safety check: PassCustom licence
Meeting Notes And Actionscomposio-community/awesome-codex-skills17k—~357Automated safety check: PassNone
Meeting Notesholaboss-ai/holaOS11k—~548Automated safety check: PassCustom licence
Note Takinginkeep/open-knowledge4.4k—~485Automated safety check: PassGPL-3.0
Release Notes One Pagernexu-io/open-design100k—~920Automated safety check: PassApache-2.0

Similar skills

  • Meeting Notes

    outline/outline

    Create meeting notes in Outline from a template; use when the user wants an agenda, notes, or a follow-up document for a meeting.

    41k GitHub stars~551 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Meeting Notes And Actions

    composio-community/awesome-codex-skills

    Turn meeting transcripts or rough notes into crisp summaries with decisions, risks, and owner-tagged action items; use for Zoom/Meet/Teams transcripts, call notes, or long meeting chats to generate…

    17k GitHub stars~357 tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Meeting Notes

    holaboss-ai/holaOS

    Turn raw notes or a transcript into a clean summary with decisions and action items.

    11k GitHub stars~548 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Note Taking

    inkeep/open-knowledge

    How to work in a Plain Notes project (the plain-notes starter pack): a flat notes/ folder plus a daily/ journal.

    4.4k GitHub stars~485 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Release Notes One Pager

    nexu-io/open-design

    Release notes one-page HTML with highlights, Added, Fixed, Breaking changes, Known issues, and Upgrade note.

    100k GitHub stars~920 tokensUpdated today
    DevelopmentAuto-check passed
  • Apple Notes Search

    sickn33/agentic-awesome-skills

    Semantic + keyword search and connection-discovery across the user's own Apple Notes via the apple-notes MCP server.

    47k GitHub starsUsed in 1 repo~2k tokens
    Agent WorkflowsAuto-check passed

More from iswalle/getnote-cli

  • 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 Kb

    iswalle/getnote-cli

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

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

Questions about Getnote Note

What does Getnote Note do?

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

How do I install Getnote Note in Claude Code?

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

How do I install Getnote Note in Codex?

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

Can I use Getnote Note 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-cli --skill getnote-note -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-note, .gemini/skills/getnote-note, .github/skills/getnote-note and .opencode/skills/getnote-note in your project.

What does Getnote Note need to run?

SKILL.md names no scripts, command-line tools or credentials: Getnote Note is instructions for the agent only.

Does Getnote Note 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 Note 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. Review the folder before installing.

What licence does Getnote Note use?

Getnote Note is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Getnote Note use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Getnote Note?

Skills that share tags, products or a category with Getnote Note: Meeting Notes (outline/outline, 41k stars), Meeting Notes And Actions (composio-community/awesome-codex-skills, 17k stars), Meeting Notes (holaboss-ai/holaOS, 11k stars) and Note Taking (inkeep/open-knowledge, 4.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Getnote Note?

iswalle (a GitHub user) maintains it in iswalle/getnote-cli, which has 178 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 24, 2026.

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