← Back to Skills Marketplace
makkoncept

Browser Bookmarks Cleanup

by Mayank Nader · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
450
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install browser-bookmarks-cleanup
Description
Analyze, organize, and clean browser bookmarks on macOS using on-disk bookmark and history files. Detects duplicates, stale bookmarks, tracking parameters, a...
README (SKILL.md)

Browser Bookmark Cleanup

Analyze first, organize, then clean up. All writes are opt-in and reversible.

Supported browsers: Chrome and Firefox out of the box. Other Chromium-based browsers (Edge, Brave, Arc, etc.) can be handled by pointing to their profile directories, which use the same Bookmarks JSON format as Chrome.

Workflow

  1. Discover browser profiles.
  2. Run read-only analysis and share findings.
  3. Propose cleanup plan with preview.
  4. Get explicit user approval before any writes.
  5. Dry-run first, then write with automatic backup.
  6. Report changes and how to roll back.

Hard Safety Rule

Never send network requests to bookmark URLs. Analysis uses only local files.

Commands

Discover profiles:

python3 scripts/browser_bookmarks.py discover [--browser chrome|firefox]

Analyze bookmarks:

python3 scripts/browser_bookmarks.py analyze --bookmarks "\x3CPATH>" --output /tmp/bookmark-analysis.json

Apply plan (dry-run by default, --write to commit):

python3 scripts/browser_bookmarks.py apply-plan --bookmarks "\x3CPATH>" --plan /tmp/bookmark-plan.json [--write]

Analysis Categories

  1. Exact and semantic duplicate URLs
  2. Tracking-parameter variants (utm_*, gclid, fbclid, etc.)
  3. Subdomain and domain concentration
  4. HTTP links that should be HTTPS
  5. Empty, singleton, deep, and oversized folders
  6. Weak bookmark names
  7. Old bookmarks by age
  8. Never-visited and stale bookmarks (from browser history)

Approval Gate

Before any write: show plan preview, get explicit approval, ask user to close the browser.

Plan Format

See references/plan-schema.md for the JSON plan structure.

Rollback

Restore the timestamped backup file created before any write.

Usage Guidance
This skill appears to do only local analysis and opt-in cleanup of browser bookmarks and history. Before running: (1) review the generated plan JSON before using --write, (2) run a dry-run and keep the backup files it creates, (3) close the browser before committing changes as recommended, and (4) be aware the tool reads your History (places.sqlite) which contains visited URLs — treat that data as sensitive. Note the skill package has no homepage and an unknown publisher; if you require provenance, ask the publisher for source hosting or a reproducible release before trusting it with your real profiles.
Capability Analysis
Type: OpenClaw Skill Name: browser-bookmarks-cleanup Version: 1.0.0 The OpenClaw AgentSkills bundle 'browser-bookmarks-cleanup' is benign. Its purpose is to analyze and manage local browser bookmarks and history files on macOS, which is clearly stated and consistently implemented across all scripts. The `SKILL.md` explicitly includes a 'Hard Safety Rule' against sending network requests to bookmark URLs, which is adhered to by the Python code. All file system operations (reading bookmark/history databases, creating backups, writing modified bookmark JSON) are local and directly related to the skill's stated function. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts against the agent.
Capability Assessment
✓ Purpose & Capability
Name and description match the included scripts: discovery of Chrome/Firefox profiles, read-only analysis of bookmarks/history, proposal of a JSON plan, and an opt-in apply step that creates backups. The declared scope (macOS browser files) is consistent with the hardcoded BROWSER_ROOTS and commands.
✓ Instruction Scope
SKILL.md commands map directly to the CLI scripts. The runtime instructions confine operations to local files (Bookmarks JSON, places.sqlite, History) and require explicit user approval and a --write flag for changes. The SKILL.md 'Hard Safety Rule' (no network requests to bookmark URLs) is respected by the code (no network libraries or outbound calls present).
✓ Install Mechanism
There is no install spec or external download; the skill is delivered as code files that run with the system Python. No third-party packages, remote URLs, or extract/install steps are present in the package.
✓ Credentials
The skill requests no environment variables, credentials, or external tokens. It accesses only local browser files (Bookmarks JSON, Local State, places.sqlite, History) appropriate for its stated purpose.
✓ Persistence & Privilege
The skill is not always-enabled and is user-invocable. It does not modify other skills or system-wide agent settings. Write operations are opt-in, perform a timestamped backup, and the code provides a rollback path.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install browser-bookmarks-cleanup
  3. After installation, invoke the skill by name or use /browser-bookmarks-cleanup
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of browser-bookmarks-cleanup. - Analyze, organize, and clean Chrome and Firefox bookmarks on macOS using local files. - Detect duplicate URLs, tracking parameter variants, weak names, folder issues, and stale or never-visited bookmarks. - All changes are opt-in, with dry-run and explicit user approval before any write operations. - Automatic backup and simple rollback before any modification. - Supports additional Chromium-based browsers by manually specifying their profile directories. - Guaranteed safety: no network requests to bookmark URLs.
Metadata
Slug browser-bookmarks-cleanup
Version 1.0.0
License —
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Browser Bookmarks Cleanup?

Analyze, organize, and clean browser bookmarks on macOS using on-disk bookmark and history files. Detects duplicates, stale bookmarks, tracking parameters, a... It is an AI Agent Skill for Claude Code / OpenClaw, with 450 downloads so far.

How do I install Browser Bookmarks Cleanup?

Run "/install browser-bookmarks-cleanup" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Browser Bookmarks Cleanup free?

Yes, Browser Bookmarks Cleanup is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Browser Bookmarks Cleanup support?

Browser Bookmarks Cleanup is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Browser Bookmarks Cleanup?

It is built and maintained by Mayank Nader (@makkoncept); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments