Bookmark Organizer

Imports browser bookmarks from HTML and converts them into a deduplicated, categorized, time-sorted Markdown knowledge base with optional dead-link checking.

Security Scan

The skill's code and instructions match its description (parsing, deduping, categorizing bookmarks); the main issues to be aware of are that the optional dead-link check performs outbound requests using the curl binary (not declared as a dependency) and those requests can expose your IP/metadata to URLs in your bookmarks.

Purpose & Capability

The name/description match the included scripts and rules.json: both scripts parse bookmark HTML, categorize, deduplicate, and emit Markdown. One minor inconsistency: the dead-link checker uses the system curl via subprocess.run but the skill declares no required binaries. Otherwise the required files (rules.json) and behavior are proportional to the stated purpose.

Instruction Scope

SKILL.md accurately instructs running the included scripts. The optional --check-links triggers many outbound HTTP requests (via curl) to arbitrary URLs from the user's bookmarks — this is expected for dead-link checking but is a privacy/metadata leakage risk. The instructions do not ask for unrelated files, environment variables, or external endpoints beyond the user's bookmarks.

Install Mechanism

No install spec (instruction-only with included code files). Nothing is downloaded at install time and the repository includes all source files, so there is no high-risk install mechanism.

Credentials

The skill requests no environment variables or credentials and the code does not read any secrets or unrelated config paths. That is proportionate to the described functionality.

Persistence & Privilege

The skill is not always-enabled and is user-invocable by default. It does not attempt to modify other skills or system-wide configuration; it only writes outputs to the user-specified directory.

Assessment

This skill appears to do what it says: parse bookmarks and emit categorized Markdown. Before installing or running it, consider the following: (1) If you use the --check-links flag the script will make outbound HTTP requests (via curl) to every bookmark URL — that can reveal your IP and that you accessed those URLs. Run without --check-links if you want an offline run. (2) Ensure curl is available on the host (the script calls it but the skill metadata doesn't list it as a required binary). (3) Inspect rules.json to adjust categorization keywords to your needs. (4) Run the scripts on a copy of your bookmarks in a safe directory, and consider running link-checking in an environment where you are comfortable with outbound traffic (or behind a proxy/vpn). (5) If you are concerned about privacy or malicious URLs, do not enable --check-links or run the check from a sensitive network.

---

name: bookmark-organizer description: Imports a browser bookmark HTML file and transforms it into a structured, categorized, and time-sorted Markdown knowledge base. Includes features for deduplication, dead-link checking, and customizable classification rules.

Bookmark Organizer Skill (v1.0)

This skill provides a robust, reusable script to turn a standard browser bookmark export file (HTML) into a clean, categorized, and searchable knowledge base in Markdown format.

Core Features

• Parses Standard Bookmark Files: Extracts links, titles, and creation dates.
• Automatic Deduplication: Processes each unique URL only once.
• Customizable Categorization: Uses an external rules.json file, allowing any user to define their own categories and keywords without editing code.
• Dead Link Checking: An optional flag (--check-links) finds and reports broken or inaccessible links, and excludes them from the final lists.
• Time-Sorted Output: All lists are sorted chronologically with the newest bookmarks first.

How to Use

1. (Optional) Customize Rules

To change how links are categorized, edit the rules.json file located in the script's directory.

File: skills/bookmark-organizer/scripts/rules.json

2. Run the Organizer Script

Execute the organize.py script, providing the input HTML path and a desired output directory. Use the optional --check-links flag to perform a network check on all URLs.

Command:

python3 /path/to/organize.py <input_file> <output_dir> [--check-links]

Example:

# Define paths
SKILL_SCRIPT="/root/.openclaw/workspace-aii/skills/bookmark-organizer/scripts/organize.py"
INPUT_FILE="./bookmarks/import/bookmarks.html"
OUTPUT_DIR="./bookmarks/organized_v1"

# Create output directory
mkdir -p $OUTPUT_DIR

# Run the script (with dead link checking)
python3 $SKILL_SCRIPT $INPUT_FILE $OUTPUT_DIR --check-links

3. Review the Output

The script will generate:

• Markdown files for each category (e.g., ai-art.md, games-mods.md).
• A _SUMMARY.md file with statistics.
• If checked, a _dead_links_report.md file.

Start by inspecting _SUMMARY.md to get an overview.