edwinhu/readwise-search
skills/readwise-search/SKILL.md
Search Readwise highlights. Use when the user wants to find highlights, quotes, notes, or annotations from their reading library. Triggers on "search highlights", "find in readwise", "what did I highlight about", "my notes on".
$ install --global
skillsauthnpx skillsauth add edwinhu/workflows readwise-searchInstall 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 15, 2026, 5:09 PM318.5s1 file scanned
SKILL.md
- name:
- readwise-search
- description:
- Search Readwise highlights. Use when the user wants to find highlights, quotes, notes, or annotations from their reading library. Triggers on "search highlights", "find in readwise", "what did I highlight about", "my notes on".
- context:
- fork
- agent:
- librarian
- user-invocable:
- false
Readwise Highlight Search
Decision Tree
1. Do you know the EXACT document or author?
YES -> Use fulltext filters (--full-text-queries)
NO -> Use vector search (semantic query)
2. Need document-level results (not highlights)?
YES -> Use `readwise reader-search-documents --query "term"`
or `readwise reader-list-documents` with --tag or --category filters
NO -> Use `readwise readwise-search-highlights`
3. Need keyword-exact match in highlight text?
YES -> Use `readwise-custom highlights --search "term"` (v2 API)
NO -> Use vector search
Quick Reference
Vector + Fulltext Search (Highlights) — Official CLI
# Semantic search
readwise readwise-search-highlights --vector-search-term "fiduciary duty broker-dealer"
# With fulltext filters
readwise readwise-search-highlights --vector-search-term "regulation" \
--full-text-queries '[{"field_name": "document_author", "search_term": "Jackson"}]'
# JSON output for piping
readwise readwise-search-highlights --vector-search-term "query" --json
Fulltext filter fields (via --full-text-queries JSON array):
| field_name | Searches |
|------------|----------|
| document_author | Document author name |
| document_title | Document title |
| highlight_note | Highlight notes/annotations |
| highlight_plaintext | Highlight text content |
| highlight_tags | Tags on highlights |
Document Search (Hybrid) — Official CLI
# Hybrid search across document content
readwise reader-search-documents --query "proxy advisors"
# With filters
readwise reader-search-documents --query "regulation" --author-search "Jackson" --category-in article
readwise reader-search-documents --query "proxy" --tags-in "corps" --location-in later,archive
# By tag (no search, just filter)
readwise reader-list-documents --tag "proxy advisors" --json
# By category and location
readwise reader-list-documents --category article --location archive
# Recent updates
readwise reader-list-documents --updated-after 2026-01-01T00:00:00Z --limit 20
Keyword Highlight Search — Custom CLI
# Exact text search across highlights (v2 API)
readwise-custom highlights --search "fiduciary" --limit 20 --json
When to Use Each
| Need | Command | CLI |
|------|---------|-----|
| Semantic/conceptual highlight search | readwise readwise-search-highlights --vector-search-term "query" | Official |
| Hybrid document content search | readwise reader-search-documents --query "term" | Official |
| Keyword-exact match in highlights | readwise-custom highlights --search "term" | Custom |
| Documents by tag | readwise reader-list-documents --tag "X" | Official |
| Specific document | readwise reader-get-document-details --document-id <id> | Official |
Output Format
Use --json for structured output. JSON search results include a score field (higher = more relevant, >0.01 typically meaningful).
Related Skills
edwinhu/dewey
tools
VerifiedTrustedCommunity
Use when "query Dewey Data", "deweydata.io", "SafeGraph places/patterns/spend", "Advan foot traffic", "POI / points of interest", "mobility data", "dataplor", "Veraset", "PassBy", "crypto/Bitcoin ATM locations", or any pull from the Dewey Data academic marketplace (UVA/NYU Platform Subscription) via the deweypy/deweydatapy client, DuckDB, or the Dewey MCP server.
16SKILL.mdUpdated Jun 6, 2026
edwinhu/hpc
development
VerifiedTrustedCommunity
Use when submitting jobs to UVA HPC (Rivanna/Afton), writing Slurm scripts (sbatch/srun/squeue), converting SGE to Slurm, running compute on any Slurm-managed cluster, or building WRDS data pipelines with polars on HPC. Triggers: 'submit to HPC', 'sbatch', 'squeue', 'slurm job', 'run on Rivanna', 'run on Afton', 'HPC array job', 'convert SGE to Slurm', 'polars on HPC', 'WRDS from HPC'.
16SKILL.mdUpdated May 29, 2026
edwinhu/writing-lit-review
testing
VerifiedTrustedCommunity
Internal skill for literature review and source materialization. Called after brainstorm, before setup. NOT user-facing.
16SKILL.mdUpdated May 5, 2026
edwinhu/paperpile
development
VerifiedTrustedCommunity
This skill should be used when the user asks to "add paper", "paperpile add", "fetch PDF for", "find and add", "search paperpile", "find in paperpile", "paperpile search", "label paper", "trash paper", "download paper", "paperpile index", "edit paper metadata", "update paper title", "fix paper author", "paperpile edit", "find PDF online", "search google for PDF", "resolve PDF", "fetch PDF for citation", "get full-text for DOI", "resolve cite to PDF", or any request to manage their Paperpile library or resolve a citation to a local PDF.
16SKILL.mdUpdated Apr 30, 2026