| name | topic-bookmarks-reorganizer |
| description | Use when reorganizing a browser bookmarks export by topic, deduplicating URLs, and producing an importable HTML file. |
| license | MIT |
Topic Bookmarks Reorganizer
Overview
Reorganize one user-specified topic folder from a browser bookmarks export into a cleaner importable Netscape HTML file. The workflow analyzes the source export, extracts the target topic directory, regroups links and subfolders, removes duplicate URLs, and keeps the output browser-importable.
When to Use
Use this skill when the user asks for one or more of these tasks:
- Analyze one bookmarks export file and find a user-specified topic folder
- Re-classify links and subfolders under that topic
- Remove duplicate links by URL
- Output a new HTML file that can be imported into a browser
- Keep only the target topic folder in the output
Do not use
Do not use this skill when:
- The input is not a bookmarks export HTML file
- The user only wants manual writing help with no file processing
- The user asks for unrelated JSON/PDF/Docx transformations
Instructions
- Ask for required input:
- Export file path
- Target topic folder name
- Output file path
- Run the script in report mode first:
python3 scripts/reorganize_topic_bookmarks.py \
--input /path/to/bookmarks.html \
--output /tmp/topic-preview.html \
--topic-folder "<topic-folder-name>" \
--mode auto \
--lang en \
--report /tmp/topic-report.json \
--print-report
- Confirm final options with user only if needed:
--mode auto for automatic strategy selection--mode generic for generic strategy--no-dedupe-url to keep duplicate URLs
- Generate final output:
python3 scripts/reorganize_topic_bookmarks.py \
--input /path/to/bookmarks.html \
--output /path/to/topic-bookmarks-reorganized.html \
--topic-folder "<topic-folder-name>" \
--mode auto \
--lang en
- Validate and report:
- Confirm output file exists
- Report input links, output links, and removed duplicate count
- Confirm output contains exactly one top-level folder: the target topic
Output Expectations
- Output format is Netscape bookmarks HTML and is browser-importable
- Output contains only the target topic folder
- Links keep original
<A ...> attributes (for example add-date/icon)
- Folder structure is reorganized into high-level categories
