bookmark-ninjalisted

# Bookmark Ninja This skill parses Netscape HTML bookmark exports (the universal format produced by Chrome, Firefox, Edge, and Brave) and produces structured JSON or CSV indexes ready for agent consumption. All processing is handled by `scripts/bookmark-parser.py`. The agent's role is to recognize when a bookmark task applies and invoke the script with the appropriate flags — no API keys, no external services, no configuration. ## When to Use This Skill - **Convert browser bookmarks to agent-queryable format** — transform an exported HTML file into a structured JSON or CSV index - **Build an incremental knowledge base** — merge periodic bookmark exports into a growing index without losing existing data - **Organize accumulated research** — preserve full folder hierarchy as category breadcrumb paths (e.g., `Research > AI > Papers`) - **Verify URL liveness** — identify dead links via HEAD request checks before querying - **Merge multiple bookmark sources** — combine exports from different browsers or time periods with conflict resolution - **Archive bookmarks before browser migration** — snapshot current bookmarks as a portable index before reorganizing ## How to Run the Script The script lives at `scripts/bookmark-parser.py` relative to the skill folder. Use the path appropriate to the runtime environment. **Basic parse** — reads an HTML export and writes `bookmarks-index.json`: ```bash python3 scripts/bookmark-parser.py bookmarks.html ``` **Custom output path** — write