eigenfeed-serve

name	eigenfeed.serve
description	Serve the Eigenfeed RSS feed over HTTP for subscription in any feed reader. Use when the user wants to subscribe to their recommendations.
allowed-tools	Bash(*)

Serve Skill

Start a local HTTP server that serves the Eigenfeed RSS feed so it can be subscribed to in any feed reader.

Prerequisites

Check if local/feed.xml exists. If not, tell the user to run /eigenfeed first to generate recommendations.

Start the server

uv run python ${CLAUDE_SKILL_DIR}/scripts/serve_feed.py --data-dir local/ --port 8463

This starts a lightweight HTTP server that:

• Serves feed.xml at http://localhost:8463/feed.xml (also at /feed and /)
• Responds to /health with a simple health check
• Runs until the user stops it with Ctrl+C

Tell the user

After starting, tell the user:

1. Open their feed reader and add a new feed
2. Enter the URL: http://localhost:8463/feed.xml

The feed will update whenever they re-run /eigenfeed. The server serves whatever is currently in local/feed.xml.

Note: The server must be running for the feed reader to fetch updates. The user can also point their reader at the file directly using a file:// URL: file://${PWD}/local/feed.xml