chrome-bookmarks

Organizes Chrome bookmarks into a clean, categorized structure.

When to Use

• User asks to "organize bookmarks", "clean up bookmarks", "sort bookmarks"
• User wants to "categorize bookmarks", "import bookmarks", "export bookmarks"
• User says bookmarks are "messy", "chaotic", "too many folders"
• User wants to remove duplicates or clean invalid links

Quick Usage

Run the Python script from references:

python skills/chrome-bookmarks/references/organize_bookmarks.py

Or with custom paths:

python skills/chrome-bookmarks/references/organize_bookmarks.py \
  --input "/path/to/Bookmarks" \
  --output "/path/to/output.html" \
  --show-count

Manual Process

For manual bookmark organization, follow these steps:

Step 1: Read Chrome Bookmarks File

name: chrome-bookmarks description: Organizes Chrome bookmarks into categorized folders. Use when user asks to clean, organize, sort, categorize, or tidy up Chrome bookmarks, or import/export bookmarks.

Chrome Bookmarks Organizer

Organizes Chrome bookmarks into a clean, categorized structure.

When to Use

• User asks to "organize bookmarks", "clean up bookmarks", "sort bookmarks"
• User wants to "categorize bookmarks", "import bookmarks", "export bookmarks"
• User says bookmarks are "messy", "chaotic", "too many folders"
• User wants to remove duplicates or clean invalid links

Instructions

Step 1: Read Chrome Bookmarks File

Chrome stores bookmarks in a JSON file:

Windows:

%LOCALAPPDATA%\Google\Chrome\User Data\Default\Bookmarks

Mac:

~/Library/Application Support/Google/Chrome/Default/Bookmarks

Linux:

~/.config/google-chrome/Default/Bookmarks

Read the file and parse the JSON structure. The bookmarks are in roots.bookmark_bar.children.

Step 2: Extract All Bookmarks

Recursively extract all URLs from folders:

• Each bookmark has: name, url, date_added, date_last_used
• Folder type: type: "folder" with children
• URL type: type: "url" with url field

Step 3: Categorize by Domain

Use domain matching to assign categories. Key categories:

| Category | Domain Keywords | |----------|-----------------| | AI | openai, anthropic, gemini, deepseek, claude, chatgpt, huggingface, colab, stability, leonardo, civitai | | Development | github, gitlab, stackoverflow, geeksforgeeks, spring, maven, gradle, pypi, docker | | Frontend | vuejs, reactjs, tailwindcss, webpack, vite, css, flexbox, heroicons, figma | | Database | mysql, postgres, mongodb, redis, kafka, elasticsearch, flink | | Cloud | aliyun, tencentcloud, aws, azure, firebase, cloudflare, vercel | | Network | namesilo, godaddy, domain, dns, speedtest | | Tools | notion, feishu, dingtalk, wechat, excalidraw | | Media | youtube, bilibili, vidhub, onedrive, sm.ms | | Tech-News | zhihu, juejin, cnblogs, csdn, medium, techcrunch | | Software | crack, activation, download (for software download sites) | | Personal | icloud, personal domains |

Step 4: Remove Duplicates

Normalize URLs (remove trailing slash, lowercase) and keep only unique URLs.

Step 5: Generate HTML Export

Generate Chrome-compatible bookmarks HTML:

<!DOCTYPE NETSCAPE-Bookmark-file-1>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8">
<TITLE>Bookmarks</TITLE>
<H1>Bookmarks</H1>
<DL><p>
    <DT><H3>Category Name</H3>
    <DL><p>
        <DT><A HREF="https://..." ADD_DATE="...">Bookmark Name</A>
    </DL><p>
</DL><p>

Step 6: User Import Guide

Tell user to:

1. Open Chrome: Ctrl+Shift+O
2. Click menu → Import/Export
3. Select "Import bookmarks"
4. Choose the generated HTML file

Common Pitfalls

• Don't delete original bookmarks - generate new organized file for import
• Keep folder count reasonable (10-15 max) to avoid too many folders
• Remove duplicates but preserve unique bookmarks
• Use forward slashes in all paths, even on Windows
• Include ADD_DATE timestamp from original bookmarks

Output

A single .html file that can be imported into Chrome bookmarks manager.