← Back to Skills Marketplace
bjesuiter

Nb

by bjesuiter · GitHub ↗ · v1.0.2
darwinlinux ✓ Security Clean
2885
Downloads
1
Stars
2
Active Installs
3
Versions
Install in OpenClaw
/install nb
Description
Manage notes, bookmarks, and notebooks using the nb CLI. Create, list, search, and organize notes across multiple notebooks with Git-backed versioning.
Usage Guidance
This SKILL.md is an instructions-only wrapper around the nb CLI and appears internally consistent. Before installing or using it: 1) Ensure the nb binary you have on PATH is from the official project (review the GitHub repo/releases) because the skill will invoke that binary directly. 2) Understand that your notes live under ~/.nb/ and Git remotes used by nb sync will transmit data to whatever remotes you have configured — confirm those remotes are trusted. 3) Be cautious about the contradictory guidance: the doc warns not to edit files by hand but also shows a manual cp/git workflow; prefer using the nb CLI for changes to avoid indexing or commit issues and back up ~/.nb before trying manual operations. 4) No environment variables are required by the skill itself, but git operations will use your existing git/SSH credentials — review your git credential helpers and remotes if you have privacy concerns.
Capability Analysis
Type: OpenClaw Skill Name: nb Version: 1.0.2 The skill bundle is benign. It provides comprehensive documentation for interacting with the `nb` command-line note-taking tool. All commands and instructions in `SKILL.md` are directly related to managing notes, bookmarks, and notebooks, including Git operations for versioning. While the `nb` tool inherently involves file system access (to `~/.nb/`) and network access (for `nb sync` Git operations), and allows arbitrary Git commands via `nb git <command>`, these are core functionalities of the `nb` tool itself and are not presented with any malicious intent or instructions for the AI agent to misuse them. There is no evidence of data exfiltration, malicious execution, persistence, prompt injection attempts against the agent, or obfuscation.
Capability Assessment
Purpose & Capability
The skill requires the nb binary and the SKILL.md consistently documents nb usage and the ~/.nb notebook directory — this matches the described purpose. Minor inconsistency: the registry metadata lists no required config paths even though the instructions repeatedly reference and operate on ~/.nb/.
Instruction Scope
Instructions stay within the scope of a local note manager (running nb, git, cp, editing files under ~/.nb). One small contradiction: the file warns 'Never edit files in nb git repos by hand!' but the 'Common Patterns' section shows a manual cp into ~/.nb/ followed by git add/commit and an index rebuild. This is not a security red flag by itself but is confusing and could lead to accidental data loss or indexing issues.
Install Mechanism
Instruction-only skill with no install spec or downloads — lowest-risk footprint. It simply requires the nb CLI to already be present on PATH.
Credentials
The skill declares no required environment variables or credentials, which is appropriate. Reminder: git-based operations (nb sync, nb git) will use the user's existing Git/SSH/credential-helper configuration to reach remotes, so network transmission of notes depends on your git remotes and credentials rather than this skill declaring secrets.
Persistence & Privilege
The skill does not request always:true or other elevated persistence. It is user-invocable and can be invoked autonomously per platform defaults — expected behavior for skills. No evidence it modifies other skills or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install nb
  3. After installation, invoke the skill by name or use /nb
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Added skill author and homepage to SKILL.md metadata. - No functional changes to CLI commands or documentation content. - Minor metadata enhancements for transparency and attribution.
v1.0.1
- Removed section "JB's Notebooks" and its specific notebook examples for a more generic documentation. - Updated the "Data Location" section to use example notebook names (`notebook-name-1`, `notebook-name-2`) instead of user-specific notebooks. - The skill's usage and command examples remain unchanged. - Improved documentation clarity and made references more general-purpose for all users.
v1.0.0
Initial release: nb command line note-taking skill
Metadata
Slug nb
Version 1.0.2
License
All-time Installs 2
Active Installs 2
Total Versions 3
Frequently Asked Questions

What is Nb?

Manage notes, bookmarks, and notebooks using the nb CLI. Create, list, search, and organize notes across multiple notebooks with Git-backed versioning. It is an AI Agent Skill for Claude Code / OpenClaw, with 2885 downloads so far.

How do I install Nb?

Run "/install nb" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Nb free?

Yes, Nb is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Nb support?

Nb is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).

Who created Nb?

It is built and maintained by bjesuiter (@bjesuiter); the current version is v1.0.2.

💬 Comments