Agent skill

Getnote Auth

by iswalle in iswalle/getnote-cli

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

MITAuto-check passed

Install Getnote Auth

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

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

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

At a glance

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

  • Works in 7 steps: 用 command -v getnote 检查 CLI;不要因为 Skill… → CLI 缺失时检查 node --version 和 npm… → 执行 getnote version,必须能够正常启动。 → …
  • SKILL.md covers 首次安装闭环, 日常路由, 每条命令的结果与下一步 and 更新闭环, plus 1 more section
  • Calls npm and node

What it does

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

Its SKILL.md is about 1.1k 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-auth”

Requirements

  • Node.js

Workflow steps

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

  1. 用 command -v getnote 检查 CLI;不要因为 Skill 已安装就假设 CLI 存在。独立的 ClawHub/OpenClaw Skill 由平台管理 CLI 依赖,不查找或运行 scripts/install.sh。
  2. CLI 缺失时检查 node --version 和 npm --version,再自动执行 npm install -g @getnote/cli@latest。这是 Agent 的工作,不要求用户手工复制命令;只有系统弹出安装授权时才请用户确认。
  3. 执行 getnote version,必须能够正常启动。
  4. 执行 getnote auth status。未登录时运行 getnote auth login,让用户只在浏览器中确认,不索要 API Key、Cookie 或 Authorization。
  5. 执行 getnote doctor -o json。只有 diagnostics_completed=true、ready=true 且 status=ready,才能宣布完整连接;ready=true,status=degraded…
  6. 在 Codex、Claude Code 或 Cursor 等本地 Agent 中,执行 getnote setup 同步 5 个领域 Skill;如果当前平台已经由独立 Skill 包携带这些领域 Skill,或 CLI…
  7. 先用 getnote notes --limit 1 -o json 做无写入验收。只有用户同意创建测试内容时,才保存测试笔记。

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

    Shell commands in SKILL.md call:

    • npm
    • node

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

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    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 Auth loads about 1.1k tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 361 words of instructions outside code blocks.

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

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). 361 words, ~1,082 tokens.

Download SKILL.mdSave it as .claude/skills/getnote-auth/SKILL.md (or your agent's skills folder).
name
getnote-auth
description
安装和连接得到大脑,完成浏览器授权、环境诊断、配额检查、CLI 升级与领域 Skill 同步。用户说“安装/连接/登录/更新得到大脑”“检查为什么不能用”“查看额度”时使用。

得到大脑连接、诊断与升级

负责把“用户想用得到大脑”推进到真正可执行的状态。不要只说“已安装”:CLI 可执行、账号已授权、API 可读三项都通过才算连接成功。

首次安装闭环

按顺序执行,已经满足的步骤直接跳过:

  1. 用 command -v getnote 检查 CLI;不要因为 Skill 已安装就假设 CLI 存在。独立的 ClawHub/OpenClaw Skill 由平台管理 CLI 依赖,不查找或运行 scripts/install.sh。
  2. CLI 缺失时检查 node --version 和 npm --version,再自动执行 npm install -g @getnote/cli@latest。这是 Agent 的工作,不要求用户手工复制命令;只有系统弹出安装授权时才请用户确认。
  3. 执行 getnote version,必须能够正常启动。
  4. 执行 getnote auth status。未登录时运行 getnote auth login,让用户只在浏览器中确认,不索要 API Key、Cookie 或 Authorization。
  5. 执行 getnote doctor -o json。只有 diagnostics_completed=true、ready=true 且 status=ready,才能宣布完整连接;ready=true,status=degraded 表示核心能力可用但仍应处理警告。success 和旧 checks 字段仅用于兼容。若未就绪,先处理 issues[].blocking=true,再按 next_actions[] 修复。需要确认的动作不得静默执行。
  6. 在 Codex、Claude Code 或 Cursor 等本地 Agent 中,执行 getnote setup 同步 5 个领域 Skill;如果当前平台已经由独立 Skill 包携带这些领域 Skill,或 CLI 明确提示未检测到受支持平台,不把这一步失败误报成账号连接失败。
  7. 先用 getnote notes --limit 1 -o json 做无写入验收。只有用户同意创建测试内容时,才保存测试笔记。

日常路由

意图命令
登录getnote auth login
查看登录状态getnote auth status
退出登录getnote auth logout
诊断连接getnote doctor -o json
查看 CLI 能力契约getnote capabilities -o json
为本机 AI 同步领域 Skillgetnote setup
查看 AI 对话额度getnote quota -o json
查看版本getnote version
检查升级getnote update --check
执行升级getnote update

参数不确定时读取对应命令的 --help,不要凭旧文档猜参数。

每条命令的结果与下一步

命令成功后读取/确认成功后怎么做
getnote auth login浏览器已确认,凭证已写入本机再运行 doctor -o json;不在聊天中展示凭证。
getnote auth statusAuthenticated / Not authenticated 或环境变量登录状态未登录才启动 auth login;状态里只能出现掩码。
getnote auth logoutLogged out successfully.只说明本机已退出;不声称已撤销服务端授权。
getnote doctor -o jsondiagnostics_completed、local_ready、ready/status/summary、checks[]、issues[]、next_actions[]、update、integrations[]ready=true,status=ready 才表示完整可用;degraded 需继续处理警告。platforms[] 仅表示检测到应用或命令,不能证明 Skill 已安装;用 integrations[].skill_status/ready 判断 AI 接入状态。
getnote capabilities -o jsoncontract_version、commands、command_aliases、command_results、guarantees只在安装、升级或兼容排查时读取;这是命令和结果字段的唯一事实源。
getnote setup -o jsonsuccess、targets[]、installed_cli、installed_skills、authenticated、platforms[]、next_actions[]、nextplatforms[].status=installed 表示本地安装完成;verify_in_platform 表示 OpenClaw(小龙虾)或 QClaw 由平台管理,只引导用户完成对应的唯一 next_action。没有识别到 AI 平台不影响 CLI 和账号连接。
getnote quota -o jsondata.read/write/write_note 下的 daily/monthly.limit/used/remaining/reset_at按真实桶说明剩余额度,不自行换算或合并桶。
getnote version版本文本只用于展示版本;机器契约仍以 capabilities -o json 为准。
getnote update --check当前/可用新版本文本有新版本再运行 getnote update。
getnote updateCLI 更新、Skills 同步和 doctor 验证结果默认由新版 CLI 自动完成完整更新闭环;只有全部步骤成功才能说升级完成。只升级 CLI 时使用 --cli-only。

所有命令以退出码为第一判断:退出码非 0 即失败。使用 -o json 的 API 与本地错误均返回 success=false、data=null、error.code/message/reason/retryable 和可选 request_id;不能把 HTTP 200 或“命令运行过”当成成功。

Show full SKILL.md (95 more words)Show less
Doctor 机器决策规则
  1. diagnostics_completed=false 或命令退出非 0:诊断本身失败,不能根据残缺输出操作。
  2. ready=true:CLI、账号授权和 OpenAPI 连通性均可用;若 status=degraded,核心能力可用但仍有非阻断警告。
  3. status=partial:通常是 --offline 跳过远端检查;读取 local_ready 判断本地环境,ready=null 表示远端未知,不得声称已连接。
  4. issues[].blocking=true:按顺序优先处理;保留 code、details.request_id 和错误字段。
  5. next_actions[]:requires_confirmation=true 时先向用户确认,再执行精确 command;执行后重新运行 doctor 验证。
  6. integrations[].detected=true 只表示发现宿主;只有 skill_status=installed 且 ready=true 才能确认 CLI 可验证的 Skill 已齐全。unverified 表示安装状态由平台管理,应让用户在平台内确认,不能猜测成功。
  7. update.update_available=true 是非阻断警告;用户明确要求升级后才执行升级动作。

更新闭环

用户说“帮我更新得到大脑”已经构成完整更新授权;不要再让用户选择 CLI、领域 Skill 等内部组件:

  1. 执行 getnote update --check;有新版本或需要刷新 Skills 时执行 getnote update。命令会升级 CLI,再由新版 CLI 自动运行 setup 和 doctor,并同步 CLI 随附的五个领域 Skill。
  2. ClawHub/OpenClaw 托管的独立聚合 Skill 由平台更新;getnote update 不下载或覆盖该 Skill。若宿主支持检查 Skill 更新则继续使用宿主流程,否则只告知用户唯一必要的确认入口。
  3. 检查更新输出中的 CLI 版本、五个领域 Skill 同步结果和 doctor 结果。
  4. 用最近笔记读取做验收,再告诉用户版本、诊断结果和仍需动作。

安全与恢复

  • 不展示或记录完整凭证;auth status 只能出现掩码。
  • 用户未明确要求时不退出登录。
  • 授权超时、拒绝或验证码过期时重新启动一次登录流程,不复用旧 code。
  • 失败时保留执行步骤、错误原因和 request_id;不要只回复“连接失败”。

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

Open the folder on GitHubat commit 98275f0

Compare with similar skills

Getnote Auth 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 Auth compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Getnote Auth this skilliswalle/getnote-cli178—~1.1kAutomated safety check: PassMIT
AuthEpicenterHQ/epicenter4.8k—~7kAutomated safety check: PassCustom licence
Authmicrosoft/apm4k—~756Automated safety check: PassMIT
Clerk Authdavila7/claude-code-templates32k5 repos~376Automated safety check: PassMIT
Clerk Authsickn33/agentic-awesome-skills47k2 repos~355Automated safety check: PassMIT
Nextjs Supabase Authdavila7/claude-code-templates32k4 repos~346Automated safety check: PassMIT

Similar skills

  • Auth

    EpicenterHQ/epicenter

    Epicenter auth packages: @epicenter/auth and the Svelte adapter at @epicenter/auth/svelte, OAuth sessions, identity state, auth-owned fetch/WebSocket, and the reload gate that makes a page lifetime…

    4.8k GitHub stars~7k tokensUpdated today
    Backend & APIsAuto-check passed
  • Auth

    microsoft/apm

    Official

    Activate when code touches token management, credential resolution, git auth flows, GITHUBAPMPAT, ADOAPMPAT, AuthResolver, HostInfo, AuthContext, or any remote host authentication -- even if 'auth'…

    4k GitHub stars~756 tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Clerk Auth

    davila7/claude-code-templates

    Expert patterns for Clerk auth implementation, middleware, organizations, webhooks, and user sync Use when: adding authentication, clerk auth, user authentication, sign in, sign up.

    32k GitHub starsUsed in 5 repos~376 tokens
    Backend & APIsAuto-check passed
  • Clerk Auth

    sickn33/agentic-awesome-skills

    Expert patterns for Clerk auth implementation, middleware, organizations, webhooks, and user sync

    47k GitHub starsUsed in 2 repos~355 tokens
    Backend & APIsAuto-check passed
  • Nextjs Supabase Auth

    davila7/claude-code-templates

    Expert integration of Supabase Auth with Next.js App Router Use when: supabase auth next, authentication next.js, login supabase, auth middleware, protected route.

    32k GitHub starsUsed in 4 repos~346 tokens
    Backend & APIsAuto-check passed
  • Browser Auth Flow

    ruvnet/ruflo

    Probe a site's authentication flow for redirect leaks, missing CSRF, weak session cookies, and OAuth misconfiguration; produces an auth findings.md

    74k GitHub stars~805 tokensUpdated today
    Backend & APIsAuto-check: notes

More from iswalle/getnote-cli

  • Getnote Note

    iswalle/getnote-cli

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

    178 GitHub stars~1.2k tokensUpdated 14 days ago
    Auto-check passed
  • 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 Kb

    iswalle/getnote-cli

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

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

Questions about Getnote Auth

What does Getnote Auth do?

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

How do I install Getnote Auth in Claude Code?

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

How do I install Getnote Auth in Codex?

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

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

What does Getnote Auth need to run?

Going by SKILL.md and its folder, Getnote Auth needs the command-line tools its instructions call (npm and node). Our summary lists: Node.js.

Does Getnote Auth access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Getnote Auth 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 Auth use?

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

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Auth?

Skills that share tags, products or a category with Getnote Auth: Auth (EpicenterHQ/epicenter, 4.8k stars), Auth (microsoft/apm, 4k stars), Clerk Auth (davila7/claude-code-templates, 32k stars) and Clerk Auth (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Getnote Auth?

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.