Agent skill

Annotate

by plustar35 in plustar35/echo-reading

给一本书某个阅读单元的原文,写一条划线批注笔记,存进旁车 NN.notes.md(原文不动), 让 Obsidian 高亮那段、点开看笔记。当陪读 / 讨论中聊清了原文某处此处的意思、想留个重读时 就地浮现的记号,或用户说「给这段写个批注 / 记个笔记 / 标一下这里 / 划线记一下 / 在这旁边记一笔」时, 使用本…

No licenceAuto-check passed

Install Annotate

skills CLI
$ npx skills add plustar35/echo-reading --skill annotate -a claude-code

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

GitHub CLI
$ gh skill install plustar35/echo-reading annotate --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/plustar35/echo-reading.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/annotate .claude/skills/annotate && 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
annotate
GitHub stars
145
Token cost
~446 tokens
SKILL.md length
79 words
Files
2 (incl. scripts)
Skills in repo
4
Repo updated
First seen
Licence
None found

At a glance

给一本书某个阅读单元的原文,写一条划线批注笔记,存进旁车 NN.notes.md(原文不动), 让 Obsidian 高亮那段、点开看笔记。当陪读 / 讨论中聊清了原文某处此处的意思、想留个重读时 就地浮现的记号,或用户说「给这段写个批注 / 记个笔记 / 标一下这里 / 划线记一下 / 在这旁边记一笔」时, 使用本…

  • Works in 2 steps: 认准是哪个单元(book / chapter / unit),锚点回 NN.md… → 跑脚本,从 stdin 喂一段 JSON(SKILL = 本 skill 目录)
  • SKILL.md covers 锚点划哪段, 怎么写一条, 几条要把握的 and 脚本产出的 callout 长这样(供对照)
  • Runs Python scripts from its folder; calls python3

What it does

Annotate is an agent skill from plustar35/echo-reading. 给一本书某个阅读单元的原文,写一条划线批注笔记,存进旁车 NN.notes.md(原文不动), 让 Obsidian 高亮那段、点开看笔记。当陪读 / 讨论中聊清了原文某处此处的意思、想留个重读时 就地浮现的记号,或用户说「给这段写个批注 / 记个笔记 / 标一下这里 / 划线记一下 / 在这旁边记一笔」时, 使用本 skill。划线范围默认就是用户带进上下文的那段原文,逐字照抄;脚本把锚点对原文做精确校验、按格式写入。

Its SKILL.md is about 450 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/write_note.py`).

It works with Obsidian. The repository describes itself as: 跟 Claude Code 一起深读一本书的笔记本骨架——这是一种对话式深读一本书的体验,让读书变成一次次与claude的促膝长谈。

Example prompts

  • “/annotate”

Requirements

  • Python 3

Workflow steps

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

  1. 认准是哪个单元(book / chapter / unit),锚点回 NN.md 核对、取它在原文里的逐字写法——标点、全 / 半角都要对上,脚本按精确子串校验,对不上会报错。
  2. 跑脚本,从 stdin 喂一段 JSON(SKILL = 本 skill 目录)

What it can do on your machine

Read from SKILL.md and the folder at commit e1343db. 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 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Annotate loads about 446 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 79 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 79 words (~446 tokens).

“批注 = 贴在阅读单元 NN.md 某段原文上的划线笔记,存进同目录旁车 NN.notes.md,原文一字不改。读的时候 Obsidian 的 notes-anchor 插件会把那段高亮、点开显示笔记。”

— opening of SKILL.md by plustar35
name
annotate

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (scripts) in .claude/skills/annotate of plustar35/echo-reading.

  • SKILL.md
  • scripts/write_note.py

Open the folder on GitHubat commit e1343db

Compare with similar skills

Annotate 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.

Annotate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Annotate this skillplustar35/echo-reading145—~446Automated safety check: PassNone
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0
Knap Markdown Templateskepano/obsidian-skills49k2 repos~986Automated safety check: PassMIT
JSON Canvasheyitsnoah/claudesidian2.6k18 repos~3.5kAutomated safety check: PassMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
Bounded AutoresearchAgriciDaniel/claude-obsidian15k1 repos~1.6kAutomated safety check: PassMIT

Similar skills

  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Knap Markdown Templates

    kepano/obsidian-skills

    Renders Markdown notes from Knap templates and JSON data on the command line, including notes built from Defuddle web page output.

    49k GitHub starsUsed in 2 repos~986 tokens
    Documents & OfficeAuto-check passed
  • JSON Canvas

    heyitsnoah/claudesidian

    Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections.

    2.6k GitHub starsUsed in 18 repos~3.5k tokens
    DevelopmentAuto-check passed
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Bounded Autoresearch

    AgriciDaniel/claude-obsidian

    Runs a bounded, source-grounded research loop that drafts a cited dossier and can propose a separately reviewed merge into an Obsidian vault.

    15k GitHub starsUsed in 1 repo~1.6k tokens
    Knowledge ManagementAuto-check passed
  • Obsidian CLI

    Atmosphere/atmosphere

    Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more.

    3.8k GitHub starsUsed in 13 repos~795 tokens
    Knowledge ManagementAuto-check passed

More from plustar35/echo-reading

  • Book Ingest

    plustar35/echo-reading

    把用户提供的书源文件(epub / mobi / azw / azw3 / prc / md / markdown / 文字型 pdf)提取并按章切分, 在 echo-reading 项目里生成 books/书名/chNN/raw.md(只灌纯原文)和 progress.md,并把源文件留档进 books/书名/。当用户给出电子书文件、Markdown、文字型…

    145 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Chapter Split

    plustar35/echo-reading

    把 echo-reading 里一个章节的原文,按内容理解切成若干 「阅读单元」,每个单元生成独立的 9 段笔记骨架(原文灌满、2-7 段占位、8/9 留白)+ 一份卷层面的 00-导读.md,并把 progress.md 改成「章→单元」两层。当用户说「读《X》第 N 章 / 下一章」而该章【尚未切分】、或说「把这章切成单元 / 这章太长读着累 / 分一下段」时使用。

    145 GitHub stars~649 tokensUpdated 3 mo ago
    Auto-check passed
  • Unit Video

    plustar35/echo-reading

    把一个阅读单元的「备读」做成「领读视频 / 备读视频 / 讲解视频」: 作者第一人称、课件式讲解、16:9 横屏。当前仅支持《道德经》。从 books/道德经/chNN/NN.md 出发, 经「口播稿 → TTS 时间轴 → 分镜 atoms/steps → 渐进渲染」产出 video/道德经/chNN/NN/领读视频.mp4。用户要求把《道德经》某章、某单元或备读内容做成视频、…

    145 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed

Works with

Questions about Annotate

What does Annotate do?

给一本书某个阅读单元的原文,写一条划线批注笔记,存进旁车 NN.notes.md(原文不动), 让 Obsidian 高亮那段、点开看笔记。当陪读 / 讨论中聊清了原文某处此处的意思、想留个重读时 就地浮现的记号,或用户说「给这段写个批注 / 记个笔记 / 标一下这里 / 划线记一下 / 在这旁边记一笔」时, 使用本…. Annotate is an agent skill from plustar35/echo-reading.

How do I install Annotate in Claude Code?

Run `npx skills add plustar35/echo-reading --skill annotate -a claude-code`. Or copy the skill folder (.claude/skills/annotate in plustar35/echo-reading) into .claude/skills/annotate in your project. Claude Code loads it when a task matches its description.

How do I install Annotate in Codex?

Run `npx skills add plustar35/echo-reading --skill annotate -a codex`. Or copy the skill folder (.claude/skills/annotate in plustar35/echo-reading) into .agents/skills/annotate in your project. Codex loads it when a task matches its description.

Can I use Annotate 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 plustar35/echo-reading --skill annotate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/annotate, .gemini/skills/annotate, .github/skills/annotate and .opencode/skills/annotate in your project.

What does Annotate need to run?

Going by SKILL.md and its folder, Annotate needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Annotate 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 Annotate 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 Annotate use?

No licence was found for Annotate or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Annotate use?

About 446 tokens (SKILL.md is roughly 1.8k 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 Annotate?

Skills that share tags, products or a category with Annotate: Obsidian Bases (Atmosphere/atmosphere, 3.8k stars), Knap Markdown Templates (kepano/obsidian-skills, 49k stars), JSON Canvas (heyitsnoah/claudesidian, 2.6k stars) and Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Annotate?

plustar35 (a GitHub user) maintains it in plustar35/echo-reading, which has 145 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on June 13, 2026.

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