searching-elfeed-rss-database
Autonomously search the user's elfeed RSS feed database when researching topics they've read about, finding specific articles they mention, analyzing their reading patterns, or gathering context from their curated information sources. Invoke when the user references articles, asks about past reads, or when conversation topics overlap with likely RSS feed content (tech, programming, AI, security, etc.).
When & Why to Use This Skill
This Claude skill enables autonomous searching and analysis of a user's Emacs Elfeed RSS database. It allows the AI to retrieve specific articles, analyze reading patterns, and gather deep context from curated information sources like technical blogs, GitHub releases, and newsletters, effectively turning a personal RSS feed into an accessible knowledge engine.
Use Cases
- Personalized Research: Query curated sources for specific technical topics such as NixOS, AI agents, or security vulnerabilities to provide context-aware answers.
- Article Retrieval: Locate specific 'past reads' or mentioned articles by searching through titles, links, and regex patterns within the Elfeed database.
- Information Triage: List and summarize unread items from specific categories (e.g., +programming +unread) to help the user stay updated on high-priority feeds.
- Source Analysis: Generate statistics on reading habits and feed distribution to help users manage their information consumption and source diversity.
| name | elfeed |
|---|---|
| description | Search the user's Emacs elfeed RSS feed database containing curated feeds from Reddit, blogs, YouTube, GitHub releases, and newsletters. Use when the user asks about articles they've read, mentions RSS feeds or 'something I read', wants to research topics from their curated sources (programming, AI, security, NixOS, Emacs, etc.), or needs to triage unread items. |
Searching Elfeed RSS Database
Elfeed is the user's primary information aggregation system. This skill provides CLI access to query the database.
Quick Start
The primary tool is elfeed-cli located at:
~/.claude/skills/elfeed/scripts/elfeed-cli
Or use the absolute path from this repo:
/home/markus/repos/nixos-config/nixos-shared/claude/skills/elfeed/scripts/elfeed-cli
Most common usage:
# Search recent unread items about a topic
elfeed-cli query "topic +unread @1-week-ago" simple 20
# Get database statistics
elfeed-cli stats
# List all feeds
elfeed-cli feeds
# List all tags
elfeed-cli tags
Filter Syntax Quick Reference
Combine these operators to build queries:
| Operator | Meaning | Example |
|---|---|---|
+tag |
Must have tag | +unread, +programming, +reddit |
-tag |
Must not have tag | -unread, -youtube |
@time |
Newer than time | @1-week-ago, @3-days-ago, @1-month-ago |
#N |
Limit to N entries | #10, #50 |
text |
Title/link matches (regex) | nixos, claude.*ai |
!regex |
Title/link doesn't match | !advertisement |
=regex |
Feed URL/title matches | =simonwillison |
~regex |
Feed URL/title doesn't match | ~reddit |
Combine operators with spaces:
"+programming +unread @1-week-ago #20"
"+reddit -unread ai.*agents"
"+github =anthropic"
Common Workflows
1. Research a Topic
# Find recent articles about a topic
elfeed-cli query "topic-keyword +unread @2-weeks-ago" simple 30
2. Check Unread by Category
# Recent unread programming articles
elfeed-cli query "+programming +unread @1-week-ago" simple 20
# YouTube videos unwatched
elfeed-cli query "+youtube +unread" simple 10
3. Analyze Reading Patterns
# Get overall statistics
elfeed-cli stats
# See all feed sources
elfeed-cli feeds
# Check what tags are used
elfeed-cli tags
4. Find Specific Article
# Search by keyword across all entries
elfeed-cli query "specific-term" simple 50
# From specific source
elfeed-cli query "=simonwillison llm" simple 20
Output Formats
The query command supports three formats:
simple (default, most readable):
2025-10-19 14:30 | Blog Name | Article Title | https://example.com/articlejson (for parsing):
[{"title":"...","link":"...","date":...,"tags":[...],"feed_title":"...","feed_url":"..."}]sexp (Emacs s-expression):
((:title "..." :link "..." :date ... :tags (...) :feed-title "..." :feed-url "..."))
Important Notes
- Requires running Emacs: Uses
emacsclientto query live database - Read-only: Queries don't modify read/unread status
- Tag system: Feeds tagged by category (programming, reddit, youtube, github, etc.)
- Real-time data: Reflects current database state
Advanced Usage
Read reference.md when:
- Building complex multi-tag filters or regex patterns
- Queries produce unexpected results requiring troubleshooting
- Need performance optimization for large result sets
- Integrating with other tools (jq, pipes, etc.)