nb

What This Skill Does

The nb skill provides an interface to the nb command-line tool, enabling sophisticated note-taking, bookmarking, and task management directly from the OpenClaw agent. It leverages Git-backed version control to ensure that all your data—notes, bookmarks, and even specific notebook structures—is tracked and secure. By using this skill, you can interact with your knowledge base using natural language, allowing the agent to create, search, and organize notes across multiple notebooks without you needing to manage the underlying directory structures or Git commands manually.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/bjesuiter/nb

Use Cases

This skill is ideal for developers and power users who need a centralized, version-controlled knowledge management system. Use it to keep track of daily coding tasks, store research bookmarks for long-term projects, or maintain a personal wiki. Because it supports wiki-style linking and tags, it is excellent for building a connected "second brain" where information is easily discoverable through search queries rather than rigid file hierarchies.

Example Prompts

1. "List all my open todos in the work notebook and identify which ones are due this week."
2. "Search through all my notebooks for any notes containing 'API architecture' and summarize the findings."
3. "Bookmark this URL (https://example.com) with the tags 'reference' and 'distributed-systems' and add a note explaining why it is relevant."

Tips & Limitations

• Safety First: The most critical rule is to never modify the files within the ~/.nb/ directory manually. Always use the provided skill commands to ensure the Git indexing remains intact and your work is properly committed.
• Search Precision: Use the --and, --or, and --not flags to narrow down searches when you have a large collection of notes.
• Automation: You can pipe content using the --print flag, making it easy to feed existing note content into other OpenClaw skills.
• Versioning: Since it uses Git, you can always revert changes or view history via the nb git subcommands, making it highly resilient to accidental deletions.