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.