ReddRadar
Agent skill
readwise-prune
Clean up stale Readwise Reader documents. Use when the user wants to declutter their reading library, remove old unread articles, or manage Reader inbox. Triggers on "clean up readwise", "prune reader", "delete old articles", "declutter reading list".
Install this agent skill to your Project
npx add-skill https://github.com/edwinhu/workflows/tree/main/skills/readwise-prune
SKILL.md
Readwise Reader Prune
Two-pass stale document removal with safe defaults.
IRON LAW: Dry Run First
NEVER pass --delete without showing the user the dry-run output first.
- Run without
--delete(dry run) - Show the user the candidate list and category breakdown
- Get explicit confirmation
- THEN run with
--delete
How It Works
Pass 1: Fetch all documents updated in the last N months (the "safe set" -- these have recent activity and are never pruned).
Pass 2: Fetch all documents matching filters. Remove from candidates any document that:
- Is in the safe set (recently active)
- Has highlights (num_highlights > 0)
- Has an excluded tag
Commands
# Dry run (always do this first)
readwise-custom prune
readwise-custom prune --months 6
readwise-custom prune --category rss --location new
readwise-custom prune --exclude-tag "keep" --exclude-tag "reference"
# Limit candidates shown
readwise-custom prune --months 3 --limit 20
# JSON output (for review)
readwise-custom prune --months 6 --json
# Actually delete (after reviewing dry run)
readwise-custom prune --months 3 --delete
readwise-custom prune --category rss --months 1 --delete
Flags
| Flag | Default | Description |
|---|---|---|
--months <n> |
3 | Documents inactive for this many months are candidates |
--location <loc> |
all | Filter: new, later, shortlist, archive, feed |
--category <cat> |
all | Filter: article, email, rss, pdf, epub, tweet, video |
--exclude-tag <tag> |
none | Skip documents with this tag (repeatable) |
--limit <n> |
all | Cap number of candidates |
--delete |
false | Actually delete (default is dry run) |
--json |
false | Output as JSON |
Recommended Workflows
Weekly RSS cleanup
readwise-custom prune --category rss --months 1 --location new
# Review, then:
readwise-custom prune --category rss --months 1 --location new --delete
Quarterly deep clean
readwise-custom prune --months 6 --exclude-tag "reference"
# Review, then:
readwise-custom prune --months 6 --exclude-tag "reference" --delete
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
edwinhu/workflows
audit-fix-loop
This skill should be used when the user asks to 'iteratively improve', 'audit and fix', 'hill-climb quality', 'grade and improve', 'score and fix', 'audit loop', 'quality loop', or needs structured iterative improvement of an artifact using scored independent audits. Also use when the user invokes a ralph loop for quality improvement rather than task completion.
edwinhu/workflows
ds-spec-reviewer
Internal skill used by ds-brainstorm at Phase 1 exit gate. Dispatches a reviewer subagent to verify SPEC.md completeness before planning. NOT user-facing.
edwinhu/workflows
pptx-render
Use when the user asks to "render pptx", "show pptx slide", "compare with pptx", "pptx to image", "export pptx slide", "original slide", "show me the original", "what does the pptx look like", or needs to extract a specific PPTX slide's content for visual comparison.
edwinhu/workflows
obsidian-organize
Organize Obsidian notes according to clawd's preferences. Use when user asks to "organize notes", "move notes to right folder", "clean up vault", "tidy vault", "file this note", or when creating new notes in the Obsidian vault. Also use when moving, renaming, or categorizing notes, or when the vault root has stray files.
edwinhu/workflows
dev-verify
This skill should be used when the user asks to 'verify completion', 'check that tests pass', 'confirm feature works', or REQUIRED Phase 7 of /dev workflow (final). Enforces fresh runtime evidence before claiming completion.
edwinhu/workflows
dev
This skill should be used when the user asks to 'start a feature', 'build a feature', 'implement a feature', 'develop', 'new feature', or needs the full 7-phase development workflow with TDD enforcement.
Didn't find tool you were looking for?