cleanup

name	cleanup
description	Find duplicates, dead links and untagged items in a saved library and propose what to do about each.
when_to_use	When the user asks to tidy up their bookmarks, clean their library, deal with duplicates or broken links, or asks what needs attention.
version	1

Cleaning up a saved library

Propose, never dispose. You do not delete, merge, retag or archive anything in this skill. You produce a list the user can act on, and you act only on items they name afterwards. An agent that quietly tidies someone's library is an agent they stop trusting.

The three piles

The Bookmarks app computes these; read them rather than deriving them.

Duplicates — the same page saved more than once, matched on a normalized URL (protocol, www., trailing slash and tracking params ignored). The oldest save is treated as the original.

For each group, recommend which to keep, and say why: prefer the one whose saved copy actually captured content over a link-only save, then the one with topics already on it, then the oldest. Note when the "duplicates" are not really duplicates — a URL that serves different content over time, for instance — and leave those alone.

Broken — a link the checker got a 404 or 410 from. Note it only trusts those two codes, so a broken item is genuinely gone rather than merely unreachable. For each, check whether the saved copy still has the content: if it does, the recommendation is "keep, the archive is the point now"; if it is link-only, there is nothing left and it can go.

Untagged — no topics. Usually means enrichment failed or the page had nothing to read. Propose topics from the existing vocabulary — read it off the Topics column's options — rather than inventing new ones; a cleanup pass that adds twelve new near-synonyms has made things worse.

Write it

Group by pile. Each item: what it is, the recommendation, one clause of why, and a link. Lead with a one-line count of each pile so the user can decide where to spend their attention.

End with the single sentence they need: "Say which of these to action and I'll do it." Then stop.

Rules

• No action without an explicit instruction naming what to act on.
• If a pile is empty, say so in one line rather than omitting it — knowing there are no broken links is worth something.
• Never recommend deleting the last remaining copy of anything.