browser-bookmarks-cleanup

What This Skill Does

The browser-bookmarks-cleanup skill is a robust macOS utility designed to help users declutter, organize, and optimize their web browser bookmark collections. Over time, browser bookmark bars become filled with duplicates, broken links, tracking-heavy URLs, and unorganized folders that hinder productivity. This skill automates the discovery, analysis, and cleaning process by reading local profile data from Chrome, Firefox, and Chromium-based browsers (Edge, Brave, Arc, etc.). By leveraging a safe, local-first architecture, it ensures that your sensitive browsing data never leaves your machine. The workflow is built on a 'plan-preview-apply' model, requiring explicit user authorization before any modifications are made to your configuration files.

Installation

To install this skill, use the OpenClaw CLI tool from your terminal:

clawhub install openclaw/skills/skills/makkoncept/browser-bookmarks-cleanup

Once installed, ensure your terminal has the necessary file system permissions to access your browser's profile directory, typically found in ~/Library/Application Support/.

Use Cases

• Mass Cleanup: Quickly identify and remove hundreds of duplicate bookmarks accumulated over years of browsing.
• Link Standardization: Automatically convert legacy HTTP links to their secure HTTPS counterparts to prevent security warnings.
• Privacy Optimization: Strip tracking parameters (like utm_, gclid, and fbclid) from stored URLs to prevent cross-site tracking markers from persisting in your saved links.
• Archive Management: Find old, stale, or never-visited bookmarks based on history data and move them into a dedicated 'Archive' folder for later review.
• Folder Reorganization: Flatten deep, nested folder structures or identify empty folders that contribute to UI clutter.

Example Prompts

• "Hey OpenClaw, please scan my Chrome profile for duplicate bookmarks and suggest a cleanup plan, but don't delete anything yet."
• "Analyze my Firefox bookmarks and identify all links that contain tracking parameters or should be updated to HTTPS."
• "I've reviewed the cleanup plan generated for my Brave browser; please go ahead and execute the changes after performing a backup."

Tips & Limitations

• Browser State: Always close your browser before running the final apply command to ensure file locks are released and data corruption is prevented.
• Safety First: The skill performs a dry-run by default. Always review the generated /tmp/bookmark-plan.json file carefully before adding the --write flag.
• Backup Policy: The tool automatically creates a timestamped backup before writing changes. If an issue occurs, you can manually restore your bookmarks by overwriting the current files with these backups.
• Local-Only: This skill does not interact with the cloud or browser sync services. If you use browser sync (like Chrome Sync), your changes will be pushed to the cloud once you reopen the browser.