edwinhu/readwise-docs
skills/readwise-docs/SKILL.md
Manage Readwise Reader documents. Use when the user wants to list, save, update, or delete documents in their Reader library. Triggers on "add to reader", "save article", "list my documents", "readwise list", "reader documents".
$ install --global
skillsauthnpx skillsauth add edwinhu/workflows readwise-docsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 25, 2026, 9:34 PM2.0s1 file scanned
SKILL.md
- name:
- readwise-docs
- description:
- Manage Readwise Reader documents. Use when the user wants to list, save, update, or delete documents in their Reader library. Triggers on "add to reader", "save article", "list my documents", "readwise list", "reader documents".
- context:
- fork
- agent:
- librarian
- user-invocable:
- false
Readwise Reader Document Management
CRUD operations on the Reader document library via official CLI (readwise) and custom CLI (readwise-custom).
Commands — Official CLI (readwise)
List Documents
readwise reader-list-documents # All documents (limit 10)
readwise reader-list-documents --limit 20 # First 20
readwise reader-list-documents --tag "proxy advisors" # By tag (up to 5 for AND logic)
readwise reader-list-documents --category pdf --location archive # By category + location
readwise reader-list-documents --updated-after 2026-01-01T00:00:00Z
readwise reader-list-documents --seen false # Unseen only
readwise reader-list-documents --response-fields title,author,summary # Reduce token usage
readwise reader-list-documents --id <id> # Specific document
Filter values:
| Flag | Values |
|------|--------|
| --location | new (inbox), later, shortlist, archive, feed |
| --category | article, email, rss, highlight, note, pdf, epub, tweet, video, podcast, audiobook |
| --tag | Any tag name (up to 5 tags for AND logic) |
| --seen | true (opened), false (unopened) |
Search Documents (Hybrid)
readwise reader-search-documents --query "proxy advisors"
readwise reader-search-documents --query "regulation" --author-search "Jackson"
readwise reader-search-documents --query "AI" --category-in article --location-in later,archive
readwise reader-search-documents --query "climate" --published-date-gt 2025-01-01
Get Document
readwise reader-get-document-details --document-id <id> # Returns markdown content
Save URL
readwise reader-create-document --url https://example.com/article
readwise reader-create-document --url https://example.com --title "Title" --tags research,ai --notes "Note"
readwise reader-create-document --title "Custom Doc" --markdown "# Content..." --url "https://me.com#doc1"
Move Documents
readwise reader-move-documents --document-ids <id1>,<id2> --location archive # Max 50 per call
readwise reader-move-documents --document-ids <id> --location later
Bulk Edit Metadata
readwise reader-bulk-edit-document-metadata --documents '[{"document_id": "<id>", "seen": true}]'
readwise reader-bulk-edit-document-metadata --documents '[{"document_id": "<id>", "title": "New Title"}]'
Tags
readwise reader-list-tags # List all tags
readwise reader-add-tags-to-document --document-id <id> --tag-names important,research
readwise reader-remove-tags-from-document --document-id <id> --tag-names old-tag
Highlights
readwise reader-get-document-highlights --document-id <id>
readwise reader-create-highlight --document-id <id> --html-content "<p>passage</p>"
readwise reader-create-highlight --document-id <id> --html-content "<p>passage</p>" --note "Note" --tags concept
readwise reader-add-tags-to-highlight --document-id <id> --highlight-document-id <hid> --tag-names concept
readwise reader-set-highlight-notes --document-id <id> --highlight-document-id <hid> --notes "Updated note"
Export
readwise reader-export-documents # Full library as ZIP of markdown
readwise reader-export-documents --since-updated "2026-01-01T00:00:00Z" # Delta export
readwise reader-get-export-documents-status --export-id <id> # Check status
Commands — Custom CLI (readwise-custom)
Delete Document (not available in official CLI)
readwise-custom delete <id>
Highlights & Books (v2 API)
readwise-custom highlights # All highlights
readwise-custom highlights --search "fiduciary" # Keyword search
readwise-custom highlights --book-id 12345 --json # By source
readwise-custom books # All sources
readwise-custom books --category articles --search "law"
Upload File (PDF/EPUB)
readwise-custom upload <file.pdf>
readwise-custom upload <file.epub>
Piping & Scripting
All commands support --json for machine-readable output:
# Get IDs of all PDFs
readwise reader-list-documents --category pdf --json | jq -r '.results[].id'
# Count highlights per book
readwise-custom books --json | jq '.[] | {title, num_highlights}'
# Export all tags
readwise reader-list-tags --json > tags.json
Related Skills
edwinhu/npx-ownership-panel
development
VerifiedTrustedCommunity
Build the meeting-level proxy-voting × ownership panel on the WRDS SGE grid — ISS N-PX fund votes reduced to (item × block) direction cells, joined to institutional and mutual-fund ownership. Use when working with risk.voteanalysis_npx, N-PX fund-level votes, ISS→CRSP fund linking, index/passive/active voting blocks, or a proxy-voting panel that needs ownership attached.
17SKILL.mdUpdated Jul 28, 2026
edwinhu/crsp-v2
development
VerifiedTrustedCommunity
Use when "CRSP CIZ", "CRSP v2", "CRSP flat file format 2.0", "crsp.dsf_v2 / msf_v2", "StkDlySecurityData", "StkMthSecurityData", "StkSecurityInfoHist", "stocknames_v2", "DlyRet / MthRet / DlyPrc / MthPrc", "SHRCD or EXCHCD equivalent in new CRSP", "SIZ to CIZ migration", "CRSP data after 2024", "CRSP delisting returns", "CRSP cumulative adjustment factors", "CRSP index INDNO / INDFAM", or any CRSP stock/index query where the legacy SIZ column names no longer exist.
17SKILL.mdUpdated Jul 28, 2026
edwinhu/fuzzy-name-matching
development
VerifiedTrustedCommunity
Use when linking or deduping datasets by entity name rather than a shared key — 'fuzzy match', 'fuzzy name matching', 'entity resolution', 'record linkage', 'match company/person names', 'dedupe entity names', 'name-based join', 'bridge identifiers' (CIK ↔ permno ↔ gvkey ↔ wficn ↔ EIN ↔ personid), or any use of char n-gram TF-IDF, cosine similarity on names, `sparse_dot_topn`, or RapidFuzz at scale.
17SKILL.mdUpdated Jul 23, 2026
edwinhu/ds-tables
development
VerifiedTrustedCommunity
Use when building a publication-quality table in Python — 'regression table', 'results table', 'summary statistics table', 'etable', 'coefplot', 'great_tables', 'GT', 'gt table', 'format a table for the paper', 'export table to LaTeX/HTML', significance stars, spanners, or column formatting for a table headed into a paper, slide deck, or notebook.
17SKILL.mdUpdated Jul 23, 2026