Agent skill

Notebook

by damus-io in damus-io/notedeck

Read and edit a notebook canvas from the command line via the notebook CLI (crates/notebookcli).

Custom licenceAuto-check passed

Install Notebook

skills CLI
$ npx skills add damus-io/notedeck --skill notebook -a claude-code

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

GitHub CLI
$ gh skill install damus-io/notedeck notebook --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/damus-io/notedeck.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/notebook .claude/skills/notebook && 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
notebook
GitHub stars
316
Token cost
~1.9k tokens
SKILL.md length
943 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Custom licence

At a glance

Read and edit a notebook canvas from the command line via the notebook CLI (crates/notebookcli).

  • The user wants to view the canvas
  • SKILL.md covers Running it, Logging in, The golden rule: show before… and Commands, plus 2 more sections
  • Calls cargo
  • Add/move/edit/recolor/delete nodes

What it does

Notebook is an agent skill from damus-io/notedeck. Read and edit a notebook canvas from the command line via the notebook CLI (crates/notebookcli). Use when the user wants to view the canvas, add/move/edit/recolor/delete nodes, connect or disconnect edges, restack, seed, or rename the canvas — e.g. "show the notebook", "add a node", "move that node", "connect these two nodes".

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

When your agent uses it

  • The user wants to view the canvas
  • Add/move/edit/recolor/delete nodes
  • Disconnect edges
  • Rename the canvas — e.g

Example prompts

  • “show the notebook”
  • “add a node”
  • “move that node”
  • “/notebook”

What it can do on your machine

Read from SKILL.md and the folder at commit 33e57be. 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:

    • cargo

    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

Notebook loads about 1.9k tokens when it runs. Until then it costs about 85 tokens; SKILL.md has 943 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 943 words (~1,924 tokens).

“notebook is a CLI over a running notedeck's embedded relay. It keeps its own nostrdb cache, reconciles with the relay each run (NIP-77 negentropy, falling back to NIP-01, or fully offline against the cache), folds the canvas locally with the…”

— opening of SKILL.md by damus-io, Custom licence
name
notebook

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/notebook of damus-io/notedeck.

Open the folder on GitHubat commit 33e57be

Compare with similar skills

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

Notebook compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Notebook this skilldamus-io/notedeck316—~1.9kAutomated safety check: PassCustom licence
Canvasopenclaw/openclaw392k—~263Automated safety check: PassMIT
Canva Designerasgeirtj/system_prompts_leaks69k—~2.1kAutomated safety check: PassCC0-1.0
Jupyter Notebookmicrosoft/ai-agents-for-beginners77k—~1.1kAutomated safety check: PassMIT
Jupyter Notebookmicrosoft/ai-agents-for-beginners77k—~1.2kAutomated safety check: WarnMIT
Jupyter Notebookmicrosoft/ai-agents-for-beginners77k—~1.4kAutomated safety check: PassMIT

Similar skills

  • Canvas

    openclaw/openclaw

    Present hosted widget documents on a connected macOS panel and control panel visibility or navigation.

    392k GitHub stars~263 tokensUpdated today
    Auto-check passed
  • Canva Designer

    asgeirtj/system_prompts_leaks

    Creates and edits Canva designs, generates images and works with brand kits through the canva CLI and Canva's official MCP server, from decks to social posts.

    69k GitHub stars~2.1k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Jupyter Notebook

    microsoft/ai-agents-for-beginners

    Official

    ใช้เมื่อผู้ใช้ร้องขอให้สร้าง จัดโครงร่าง หรือแก้ไข Jupyter notebooks (.ipynb) สำหรับการทดลอง การสำรวจ หรือบทแนะนำ; ควรใช้เทมเพลตที่มาพร้อมและรันสคริปต์ช่วยเหลือ newnotebook.py…

    77k GitHub stars~1.1k tokensUpdated 20 days ago
    Data & AnalyticsAuto-check passed
  • Jupyter Notebook

    microsoft/ai-agents-for-beginners

    Official

    ប្រើនៅពេលដែលអ្នកប្រើស្នើឲ្យបង្កើត រៀបចំ (scaffold) ឬកែសម្រួល Jupyter notebooks (.ipynb) សម្រាប់សាកល្បង ស្វែងរក ឬមេរៀន; អនុសាសន៍ឲ្យប្រើទំរង់គំរូដែលភ្ជាប់មកជាមួយ និងរត់ស្គ្រីបជំនួយ newnotebook.py…

    77k GitHub stars~1.2k tokensUpdated 20 days ago
    Data & AnalyticsAuto-check: warnings
  • Jupyter Notebook

    microsoft/ai-agents-for-beginners

    Official

    အသုံးပြုပါသည်။ အသုံးပြုသူက စမ်းသပ်မှုများ၊ ရှာဖွေမှုများ သို့မဟုတ် သင်ခန်းစာများအတွက် Jupyter notebook (.ipynb) များကို ဖန်တီးရန်၊ အခြေခံဖွဲ့စည်းရန် သို့မဟုတ် တည်းဖြတ်ရန် တောင်းဆိုသောအခါ အသုံးပြုပါ။…

    77k GitHub stars~1.4k tokensUpdated 20 days ago
    Data & AnalyticsAuto-check passed
  • Jupyter Notebook

    microsoft/ai-agents-for-beginners

    Official

    A skill your agent uses when the user asks to create, scaffold, or edit Jupyter notebooks (.ipynb) for experiments, explorations, or tutorials; prefer the bundled templates and run the helper script…

    77k GitHub starsUsed in 8 repos~1k tokens
    Data & AnalyticsAuto-check passed

More from damus-io/notedeck

  • Handoff

    damus-io/notedeck

    Hand off to a fresh Dave session — ask the user what to work on next, spawn a new session in the current worktree, and send it the task as its first message.

    316 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Agentium

    damus-io/notedeck

    Query and control Dave agentic sessions from the command line via the agentium CLI (crates/agentiumcli), and find your OWN session's agentium: reference.

    316 GitHub stars~7.1k tokensUpdated 2 days ago
    Auto-check passed
  • Headway

    damus-io/notedeck

    Read and edit a Headway kanban board from the command line via the headway CLI (crates/headwaycli).

    316 GitHub stars~8.5k tokensUpdated 2 days ago
    Auto-check passed

Questions about Notebook

What does Notebook do?

Read and edit a notebook canvas from the command line via the notebook CLI (crates/notebookcli). Notebook is an agent skill from damus-io/notedeck. Read and edit a notebook canvas from the command line via the notebook CLI (crates/notebookcli).

When should I use Notebook?

Notebook fits situations like: the user wants to view the canvas; add/move/edit/recolor/delete nodes; disconnect edges; rename the canvas — e.g.

How do I install Notebook in Claude Code?

Run `npx skills add damus-io/notedeck --skill notebook -a claude-code`. Or copy the skill folder (.claude/skills/notebook in damus-io/notedeck) into .claude/skills/notebook in your project. Claude Code loads it when a task matches its description.

How do I install Notebook in Codex?

Run `npx skills add damus-io/notedeck --skill notebook -a codex`. Or copy the skill folder (.claude/skills/notebook in damus-io/notedeck) into .agents/skills/notebook in your project. Codex loads it when a task matches its description.

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

What does Notebook need to run?

Going by SKILL.md and its folder, Notebook needs the command-line tools its instructions call (cargo).

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

Notebook has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Notebook use?

About 1.9k tokens (SKILL.md is roughly 7.7k 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 Notebook?

Skills that share tags, products or a category with Notebook: Canvas (openclaw/openclaw, 392k stars), Canva Designer (asgeirtj/system_prompts_leaks, 69k stars), Jupyter Notebook (microsoft/ai-agents-for-beginners, 77k stars) and Jupyter Notebook (microsoft/ai-agents-for-beginners, 77k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Notebook?

damus-io (a GitHub organization) maintains it in damus-io/notedeck, which has 316 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 6, 2026.

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