Agent skill

Getnote Search

by iswalle in iswalle/getnote-cli

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

MITAuto-check passed

Install Getnote Search

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

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

GitHub CLI
$ gh skill install iswalle/getnote-cli getnote-search --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-search .claude/skills/getnote-search && 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-search
GitHub stars
178
Token cost
~535 tokens
SKILL.md length
145 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 5 steps: 用户没有指定知识库时,直接执行 getnote search --limit… → 用户指定知识库名称时,先按其类型执行 getnote kbs --scope… → 已确认知识库后执行 getnote search --kb --limit… → …
  • SKILL.md covers 何时使用, 执行步骤, 命令结果与用户呈现 and 失败、隐私与后续动作
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

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

Its SKILL.md is about 540 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-search”

Workflow steps

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

  1. 用户没有指定知识库时,直接执行 getnote search --limit <1-10> -o json。默认上限是 10,不能自行放大。
  2. 用户指定知识库名称时,先按其类型执行 getnote kbs --scope -o json;默认查 DEFAULT,书籍、客户档案和团队知识库分别使用 BOOKSPACE、CUSTOMER、TEAMSPACE。用返回的真实 topic_id 和 scope…
  3. 已确认知识库后执行 getnote search --kb --limit <1-10> -o json。
  4. 只从返回值读取标题、摘要、字符串 note_id 和真实 note_url。没有 note_id/note_url 的非笔记结果可以展示内容,但不能伪造“打开笔记”链接。
  5. 同一篇笔记可能因命中多个片段出现多次。面向用户列“几篇笔记”时必须按字符串 note_id 去重;若去重后不足用户要求的数量,可在上限 10 内增大 --limit 重搜,仍不足时如实返回实际数量。

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 bash).

    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 Search loads about 535 tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 145 words of instructions outside code blocks.

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

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). 145 words, ~535 tokens.

Download SKILL.mdSave it as .claude/skills/getnote-search/SKILL.md (or your agent's skills folder).
name
getnote-search
description
在得到大脑的全部笔记或指定知识库中按自然语言进行语义搜索,返回真实标题、摘要、字符串 ID 和可打开的笔记链接。

得到大脑搜索

通过官方 getnote CLI 搜索真实笔记。不要自己拼 OpenAPI 请求、笔记 ID 或访问链接。机器调用使用 -o json;只有退出码为 0 且 JSON 的 success=true 才是业务成功。

何时使用

  • “找找、搜一下、关于某主题、我之前记过什么”:使用 getnote search。
  • “最近有哪些笔记、按保存时间列出来”:交给笔记 Skill 的 getnote notes,不要把列表误当语义搜索。
  • 用户选中某一条后,再交给笔记 Skill 用 getnote note <note_id> 读取详情;搜索阶段不自动修改、移动、分享或创建笔记。

执行步骤

  1. 用户没有指定知识库时,直接执行 getnote search <query> --limit <1-10> -o json。默认上限是 10,不能自行放大。
  2. 用户指定知识库名称时,先按其类型执行 getnote kbs --scope <scope> -o json;默认查 DEFAULT,书籍、客户档案和团队知识库分别使用 BOOKSPACE、CUSTOMER、TEAMSPACE。用返回的真实 topic_id 和 scope 匹配;同名或意图不明确时必须让用户选择。
  3. 已确认知识库后执行 getnote search <query> --kb <topic_id> --limit <1-10> -o json。
  4. 只从返回值读取标题、摘要、字符串 note_id 和真实 note_url。没有 note_id/note_url 的非笔记结果可以展示内容,但不能伪造“打开笔记”链接。
  5. 同一篇笔记可能因命中多个片段出现多次。面向用户列“几篇笔记”时必须按字符串 note_id 去重;若去重后不足用户要求的数量,可在上限 10 内增大 --limit 重搜,仍不足时如实返回实际数量。

命令结果与用户呈现

搜索
bash
getnote search "支付流程" --limit 10 -o json
getnote search "客户反馈" --kb <topic_id> --limit 5 -o json

成功 JSON 的稳定字段:

字段含义Agent 如何使用
success业务是否成功只有 true 才继续呈现结果。
data.results[]搜索结果空数组是一次成功的“未找到”,不是失败。
data.results[].title笔记标题列表主标题;为空时如实显示“未命名笔记”。
data.results[].note_id笔记雪花 ID始终作为字符串原样传入后续 note 命令。
data.results[].note_url真实笔记链接只有非空时才给用户“打开笔记”。
data.results[].content命中摘要或正文片段只摘取与问题相关的短片段,不能冒充全文。
data.results[].score相关性分数仅用于内部排序,不向用户虚构“准确率”。

成功时按相关性给出编号列表,例如:

text
找到 3 条相关笔记:
1. 《支付流程优化想法》——“用户等待时增加进度提示…”
   打开:<真实 note_url>
2. 《客户支付反馈》——“…”
   打开:<真实 note_url>
你想看哪一条的详情或原文?

若 data.results=[],回复“没有找到相关笔记;可以换关键词、时间范围或指定知识库再试”,不要说“接口失败”,也不要自动扩大检索范围、创建笔记或调用模型编造结果。

失败、隐私与后续动作

  • success=false 或退出码非 0:回复失败步骤、error.message / error.reason、是否 retryable 和可选 request_id;不要将 HTTP 成功或空输出说成搜索成功。
  • 若 CLI 提示“搜索服务响应超时”,这是检索未完成,不是“没有结果”。建议稍后重试,或缩小关键词、指定知识库后再试;不要伪造空列表。
  • 检索结果可能包含私密正文。群聊或共享会话默认只展示标题、必要摘要和真实链接;用户明确要求后再展开全文。
  • 用户选中结果后,复用返回的字符串 note_id,再读取 getnote note <note_id> -o json;不要从 URL 截取或转换为数字。

© 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-search of iswalle/getnote-cli.

Open the folder on GitHubat commit 98275f0

Compare with similar skills

Getnote Search 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 Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Getnote Search this skilliswalle/getnote-cli178—~535Automated safety check: PassMIT
Getnoteiswalle/getnote-openclaw137—~1.1kAutomated safety check: PassMIT
Sn Report Format DiscoveryOpenSenseNova/SenseNova-Skills5.7k—~157Automated safety check: PassMIT
Frida Mobile Securityindex-login/MobileRE-Skill144—~3kAutomated safety check: PassMIT
Getnote Tagiswalle/getnote-cli178—~400Automated safety check: PassMIT
Getnote Noteiswalle/getnote-cli178—~1.2kAutomated safety check: PassMIT

Similar skills

  • Getnote

    iswalle/getnote-openclaw

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

    137 GitHub stars~1.1k tokensUpdated 15 days ago
    Auto-check passed
  • Sn Report Format Discovery

    OpenSenseNova/SenseNova-Skills

    用于用户希望推荐研究成品形式,或最终形式无法从需求中直接判断时。把需求解析为一个简短的 format 字符串,不创建格式文件或 schema。

    5.7k GitHub stars~157 tokensUpdated yesterday
    Auto-check passed
  • Frida Mobile Security

    index-login/MobileRE-Skill

    用于 Android/iOS 移动应用安全逆向分析:Frida 动态插桩、绕过反调试/反注入/加固壳、脱壳、加密与 native SO 层 hook、运行时行为分析、jadx-mcp 静态攻击面分析、离线 SO 静态分析(ELF 侦察/字符串/交叉引用/反汇编/JNI 判型)。用户提到"绕过检测/闪退/脱壳/加密/抓包/行为摸底/内存扫描/分析 so/ELF…

    144 GitHub stars~3k tokensUpdated 9 days ago
    SecurityAuto-check passed
  • Getnote Tag

    iswalle/getnote-cli

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

    178 GitHub stars~400 tokensUpdated 15 days ago
    Auto-check passed
  • Getnote Note

    iswalle/getnote-cli

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

    178 GitHub stars~1.2k tokensUpdated 15 days ago
    Auto-check passed
  • Getnote Auth

    iswalle/getnote-cli

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

    178 GitHub stars~1.1k tokensUpdated 15 days ago
    Auto-check passed

More from iswalle/getnote-cli

All 5 skills in this repo
  • Getnote Kb

    iswalle/getnote-cli

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

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

Questions about Getnote Search

What does Getnote Search do?

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

How do I install Getnote Search in Claude Code?

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

How do I install Getnote Search in Codex?

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

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

What does Getnote Search need to run?

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

Does Getnote Search 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 Search 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 Search use?

Getnote Search 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 Search use?

About 535 tokens (SKILL.md is roughly 2.1k 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 Search?

Skills that share tags, products or a category with Getnote Search: Getnote (iswalle/getnote-openclaw, 137 stars), Sn Report Format Discovery (OpenSenseNova/SenseNova-Skills, 5.7k stars), Frida Mobile Security (index-login/MobileRE-Skill, 144 stars) and Getnote Tag (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 Search?

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.