What input format does this skill expect?

It expects a bookmarks export in HTML format and will not process other file types.

Can I keep duplicate URLs in the topic?

Duplicates are removed by default. Use --no-dedupe-url to keep duplicates if needed.

Will the output contain only the target topic folder?

Yes. The output is a Netscape HTML file that contains exactly one top-level folder: the specified target topic.

topic-bookmarks-reorganizer

npx machina-cli add skill YangsonHung/awesome-agent-skills/topic-bookmarks-reorganizer --openclaw

Files (1)

SKILL.md

2.4 KB

Topic Bookmarks Reorganizer

Reorganize one topic folder from a browser bookmarks export into a cleaner importable file.

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

Source

git clone https://github.com/YangsonHung/awesome-agent-skills/blob/main/skills/en/topic-bookmarks-reorganizer/SKILL.mdView on GitHub

Overview

Topic Bookmarks Reorganizer analyzes a single topic folder within a bookmarks export and reorganizes its links and subfolders into a clean, categorized structure. It deduplicates URLs and outputs a browser-importable Netscape HTML file that contains only the target topic folder.

How This Skill Works

The tool loads the provided bookmarks HTML, locates the specified topic folder, and rebuilds its structure by grouping links into high-level categories while preserving A tag attributes. It then removes duplicate URLs and writes a Netscape-formatted HTML file with exactly one top-level topic folder.

When to Use It

Analyze a bookmarks export and locate a user-specified topic folder
Re-classify links and nested folders under that topic into cleaner categories
Remove duplicate URLs within the topic folder
Output a new browser-importable Netscape HTML file
Keep only the target topic folder in the final output

Quick Start

Step 1: Run in report mode to preview: 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
Step 2: Review the report and confirm final options with the user if needed (e.g., --mode auto or --mode generic, or use --no-dedupe-url to keep duplicates)
Step 3: 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

Best Practices

Provide the exact topic folder name to minimize misses
Verify the input is a valid bookmarks HTML export before running
Run in report mode first to preview results and dedupe counts
Review the output to ensure only one top-level folder exists
Test the import in a browser to confirm links and attributes are preserved

Example Use Cases

Export a 'Web Development' bookmarks folder and reorganize it into categories like Frameworks, Tutorials, and Tools
Consolidate a 'News' topic folder across multiple subfolders into a single, clean structure
Deduplicate repeated URLs such as blog posts and product pages within a topic
Generate an importable Netscape HTML file to add to a new browser profile
Validate that the output contains only the target topic folder after reorganization

Frequently Asked Questions

Add this skill to your agents