mcpField
T
topic-bookmarks-reorganizer

topic-bookmarks-reorganizer

github.com/yangsonhungProductivity1863 installsUpdated 12w ago
Repository

About topic-bookmarks-reorganizer

A skill for reorganizing a specified topic folder in a browser bookmarks export. It groups links and subfolders, removes duplicate URLs, and creates an importable Netscape HTML file containing only the target folder.

Key features

  1. 01Find a specified topic folder
  2. 02Regroup links and subfolders
  3. 03Remove duplicate URLs
  4. 04Create importable Netscape HTML
  5. 05Keep only the target folder

Use cases

  1. 01Organize a topic in a bookmarks export
  2. 02Reclassify links and subfolders
  3. 03Remove repeated bookmark URLs
  4. 04Create a topic-only browser import file

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/yangsonhung/awesome-agent-skills --skill topic-bookmarks-reorganizer

After installing, type/topic-bookmarks-reorganizerin Claude Code to confirm it loaded.

Bundled filesscripts/reorganize_topic_bookmarks.py

Details

From the project README

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

  1. Ask for required input:
  • Export file path
  • Target topic folder name
  • Output file path
  1. 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
  1. 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
  1. 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
  1. 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

Comments

Markdown supported