nanobot-runtime/skills/bookmark/SKILL.md

name, description

name	description
bookmark	Manage a personal reading list. Use when the user wants to save, list, mark as read, or remove article URLs for later reading. Triggers on "bookmark", "save URL", "read later", "reading list", "bookmarks".

Bookmark

Manage a personal reading list stored in SQLite (db/bookmark.sqlite).

Commands

All commands run via:

/home/nanobot/.local/bin/uv run /home/nanobot/.nanobot/workspace/skills/bookmark/scripts/bookmark.py <command> [args]

Add a bookmark

bookmark.py add <url> "<description>" [--tags tag1,tag2]

• url — the article URL
• description — short human-readable description (required)
• --tags — optional comma-separated tags

Example:

bookmark.py add "https://example.com/rust-async" "Async Rust patterns" --tags rust,async

List unread bookmarks

bookmark.py list [--tag <tag>]

Shows ID, URL, tags, description, and date added for each unread bookmark. Use --tag to filter.

Mark as read

bookmark.py read <id>

Marks bookmark as read (stores read_at timestamp). Does not delete — entry stays in DB.

Unmark (mark as unread again)

bookmark.py unread <id>

Show bookmark details

bookmark.py show <id>

Shows full URL, description, tags, status (read/unread), and dates. Does not change any state.

List read bookmarks (history)

bookmark.py history

Shows all bookmarks marked as read, with both added and read dates.

Output formatting

When presenting bookmark lists or details to the user, always use markdown links so URLs are clickable in WebUI and Telegram:

#3 [hackaday.com](https://hackaday.com/2026/06/02/linux-fu-taming-strace/) [linux, strace] — lepší strace

Format: #<id> [<domain>](<url>) [<tags>] — <description>

• Domain is clickable, pointing to the full URL
• Tags in brackets, comma-separated
• Description after em-dash
• Never strip URLs from the output or replace them with plain-text summaries

Workflow

1. User shares a URL → add with description and optional tags
2. User wants to see what to read → list
3. User wants to see details of a bookmark → show <id>
4. User finishes an article → read <id>
5. User wants to revisit → unread <id> or history