A secure, local-first macOS tool for analyzing, deduplicating, and restructuring browser bookmarks with a fully reversible workflow.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install browser-bookmarks-cleanup
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install browser-bookmarks-cleanup using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Browser Bookmarks Cleanup?
The Browser Bookmarks Cleanup skill is a specialized utility designed for macOS users who need to maintain a clean and efficient digital library across various browsers. By utilizing the capabilities of Openclaw Skills, this agent performs a deep dive into local browser profile directories to identify redundant, broken, or unorganized links. It supports Chrome and Firefox natively, while also providing compatibility for other Chromium-based browsers like Edge, Brave, and Arc by targeting their specific profile paths.
Security and data integrity are core pillars of this skill. It operates entirely on local on-disk files and strictly adheres to a no-network-request policy during analysis. This ensures that your private browsing data never leaves your machine. Every modification is managed through a multi-step approval gate, meaning no changes are written to your browser profiles without a detailed plan preview and explicit user consent.
Browser Bookmarks Cleanup Use Cases
- Identifying and removing exact or semantic duplicate URLs that clutter your bookmark folders.
- Stripping privacy-invasive tracking parameters such as UTM, gclid, and fbclid from existing bookmarks.
- Auditing folder hierarchies to find empty, oversized, or excessively deep structures that hinder navigation.
- Cross-referencing bookmarks with local browser history to flag stale or never-visited links for deletion.
- Automatically upgrading legacy HTTP bookmarks to secure HTTPS versions wherever possible.
How Browser Bookmarks Cleanup Works
- The agent discovers available browser profiles on the macOS system by scanning standard application support directories.
- A read-only analysis is performed on the Bookmarks and History files to categorize potential improvements.
- The skill generates a comprehensive cleanup plan in JSON format, detailing every proposed move, deletion, or edit.
- Users are presented with a plan preview and must provide explicit approval before any disk writes occur.
- The system executes a dry-run validation followed by a live commit that creates an automatic timestamped backup of the original file.
- A final report is generated, including clear instructions on how to restore from the backup if a rollback is required.
Browser Bookmarks Cleanup Setup
To begin organizing your environment with Openclaw Skills, you can use the following commands to discover and analyze your profiles:
# Discover existing browser profiles
python3 scripts/browser_bookmarks.py discover --browser chrome
# Analyze a specific bookmarks file and output the findings
python3 scripts/browser_bookmarks.py analyze --bookmarks "<PATH_TO_BOOKMARKS>" --output /tmp/bookmark-analysis.json
# Apply the generated plan (use --write to commit changes)
python3 scripts/browser_bookmarks.py apply-plan --bookmarks "<PATH_TO_BOOKMARKS>" --plan /tmp/bookmark-plan.json --write
Browser Bookmarks Cleanup Data Schema & Taxonomy
The skill organizes its operations using structured JSON formats to ensure transparency and safety:
| Component | Format | Description |
|---|---|---|
| Profile Discovery | JSON List | Paths to detected Chrome, Firefox, and Chromium profiles. |
| Analysis Report | JSON Object | Categories of issues found, including duplicates and stale links. |
| Cleanup Plan | JSON Schema | A mapped list of source IDs and target actions (Move, Delete, Update). |
| Backups | File Copy | A timestamped replica of the browser's Bookmarks file created before writes. |
Browser Bookmarks Cleanup Advanced Features
- Multi-browser support allows managing bookmarks for Chrome, Firefox, Edge, Brave, and Arc through the same Openclaw Skills interface.
- History-based staleness detection utilizes local SQLite history databases to identify bookmarks you haven't visited in months or years.
- Semantic duplicate detection goes beyond simple URL matching to find identical content across different link variations.
- Automated tracking parameter removal helps standardize your library and improves privacy.
- Safety-first rollback mechanism allows for instant recovery by restoring timestamped backup files generated during the cleanup process.
SKILL.md
Loading
Related Openclaw Skills
Microsoft 365 MCP Server
A comprehensive Model Context Protocol server that grants AI agents full access to Microsoft 365 services including Mail, Calendar, OneDrive, and Teams.
ZenCreator Video
A professional AI video generation skill for creating uncensored, high-quality content using advanced models like Kling, Wan, and Seedance Pro.
GitHub
A powerful integration enabling AI agents to manage GitHub repositories, pull requests, and CI/CD workflows via the official GitHub CLI.
Fastest Browser Use
A high-performance Rust-based browser automation engine designed for lightning-fast DOM extraction and robust session management.
People-Strategy Agent Skill
A persistent graph-based relationship management skill that enables AI agents to map, query, and analyze complex networks of people using SQLite.
Task-Todo Agent Skill
A robust task management skill for AI agents that provides persistent SQLite storage for creating, updating, and querying tasks.
Featured*
