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.
