From workflows
This skill should be used when the user asks to "search Readwise", "find highlights", "get quotes from my reading", "add highlights to notebook", "search my annotations", "get full document text", "fetch article content", "add tagged documents to notebook", or needs to query their Readwise library.
npx claudepluginhub edwinhu/workflows --plugin workflowsThis skill uses the workspace's default tool permissions.
<EXTREMELY-IMPORTANT>
Implements Playwright E2E testing patterns: Page Object Model, test organization, configuration, reporters, artifacts, and CI/CD integration for stable suites.
Guides Next.js 16+ Turbopack for faster dev via incremental bundling, FS caching, and HMR; covers webpack comparison, bundle analysis, and production builds.
Discovers and evaluates Laravel packages via LaraPlugins.io MCP. Searches by keyword/feature, filters by health score, Laravel/PHP compatibility; fetches details, metrics, and version history.
EVERY READWISE OPERATION MUST GO THROUGH LIBRARIAN. This is not negotiable.
Main chat MUST NOT:
readwise CLI commands directlyreadwise-custom CLI commands directlyIf you're about to do anything Readwise in main chat, STOP. Spawn a librarian sub-agent instead.
| Context | Readwise CLI | readwise-custom CLI |
|---|---|---|
| Main chat | FORBIDDEN | FORBIDDEN |
| Librarian sub-agent | ALLOWED | ALLOWED |
STOP if you catch yourself thinking:
- "Let me quickly search Readwise..."
- "I'll just run readwise reader-search-documents..."
- "I'll just run readwise-custom search..."
These thoughts in MAIN CHAT = VIOLATION. Delegate instead.
User: "Search my Readwise for proxy advisor articles"
MAIN CHAT RESPONSE:
Task(subagent_type="workflows:librarian", prompt="Search Readwise for proxy advisor articles and summarize findings")
NEVER IN MAIN CHAT:
readwise readwise-search-highlights --vector-search-term "proxy advisors"
readwise-custom search "proxy advisors"
| CLI | Binary | Use for |
|---|---|---|
Official (@readwise/cli) | readwise | Search, list, get, save, move, tags, highlights CRUD, export, daily review |
Custom (~/projects/readwise-cli/) | readwise-custom | Chat/RAG, ghostreader, file upload (PDF/EPUB), prune, keyword highlight search |
User mentions tagged items or NLM content
│
▼
┌──────────────────────────────────┐
│ 1. CHECK NLM FIRST │ ← MANDATORY
│ nlm list │
│ nlm chat <id> │
└──────────────────────────────────┘
│
Not in NLM?
▼
┌──────────────────────────────────┐
│ 2. USE readwise for tagged items │
│ readwise reader-list-documents│
│ --tag "X" │
│ NOT search! │
└──────────────────────────────────┘
readwise)| Need | Command |
|---|---|
| Semantic search highlights | readwise readwise-search-highlights --vector-search-term "query" |
| Search documents (hybrid) | readwise reader-search-documents --query "query" |
| Documents by tag | readwise reader-list-documents --tag "X" |
| Full document (markdown) | readwise reader-get-document-details --document-id <id> |
| List all tags | readwise reader-list-tags |
| Save URL | readwise reader-create-document --url <url> |
| Move documents | readwise reader-move-documents --document-ids <id> --location archive |
| Bulk edit metadata | readwise reader-bulk-edit-document-metadata --documents '[...]' |
| Export library | readwise reader-export-documents |
| Daily review | readwise readwise-get-daily-review |
Add --json to any command for machine-readable output.
readwise-custom)| Need | Command |
|---|---|
| RAG chat over highlights | readwise-custom chat "question" |
| Keyword search highlights | readwise-custom highlights --search "term" |
| Prune stale docs | readwise-custom prune |
| Upload PDF/EPUB | readwise-custom upload <file> |
| Ghostreader | readwise-custom ghostread summarize <id> |
| Full document (HTML) | readwise-custom get <id> --html |
Sub-skills with detailed reference:
| Skill | Purpose |
|---|---|
readwise-search | Vector + fulltext highlight search |
readwise-docs | Document CRUD (list, get, save, move, bulk edit, export) |
readwise-chat | GPT-5.1 RAG chat over highlights (fallback — prefer search + Claude synthesis) |
readwise-prune | Two-pass stale document cleanup |
uv run python3 /Users/vwh7mb/projects/workflows/skills/readwise/scripts/readwise_to_nlm.py \
--tag "proxy advisors" --tag "disclosure" \
--notebook <notebook-id>
Add --dry-run to preview. Add --verbose for detailed output.
WRONG: Search Readwise, find document, fetch from original URL (fails for paywalled content).
RIGHT: Search Readwise, get full text FROM READWISE using readwise reader-get-document-details --document-id <id>.
If a document is in Readwise, the full text is already there. Never go back to the source URL.