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.).

⭐5stars🔀0forks📁View on GitHub🕐Updated Dec 24, 2025⬇️2downloads

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.
nameelfeed
descriptionSearch 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:

  1. simple (default, most readable):

    2025-10-19 14:30 | Blog Name | Article Title | https://example.com/article
    
  2. json (for parsing):

    [{"title":"...","link":"...","date":...,"tags":[...],"feed_title":"...","feed_url":"..."}]
    
  3. sexp (Emacs s-expression):

    ((:title "..." :link "..." :date ... :tags (...) :feed-title "..." :feed-url "..."))
    

Important Notes

  • Requires running Emacs: Uses emacsclient to 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.)