# Topic Bookmarks Reorganizer

> Use when reorganizing a browser bookmarks export by topic, deduplicating URLs, and producing an importable HTML file.

- Skill: `yangsonhung/topic-bookmarks-reorganizer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add yangsonhung/topic-bookmarks-reorganizer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yangsonhung/topic-bookmarks-reorganizer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- License: MIT
- Author: yangsonhung (https://skillmd.com/u/yangsonhung)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/yangsonhung/topic-bookmarks-reorganizer

---


# 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

2. Run the script in report mode first:

```bash
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
```

3. 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

4. Generate final output:

```bash
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
```

5. 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