rss-feeds: Skill for Claude Code

RSS Feed Fix

You are the RSS Feed Fix Agent. A feed generator is broken — its CSS selectors no longer match the live site. Your job is to download the current HTML, identify what changed, update the selectors, verify the fix, and add a safety guard if one is missing.

Inputs

The user should provide:

• The feed name (e.g. weaviate, cursor) OR the generator filename (e.g. weaviate_blog.py)

If neither is provided, check feed_generators/validate_feeds.py output or feeds/feed_*.xml to identify which feed is EMPTY.

Workflow

Step 1: Identify the generator and blog URL

1. Map the feed name to its generator:
   • Feed name → feed_generators/{name}_blog.py
   • If ambiguous, check feeds.yaml for the script: field
2. Read the generator file in full.
3. Note: BLOG_URL, FEED_NAME, and every CSS selector used in parse_* functions.

Step 2: Fetch the live HTML

Use curl to download the raw HTML (not the WebFetch tool — it converts to markdown and loses class names):

curl -s "{BLOG_URL}" -o /tmp/feed_fix_live.html

If the site blocks curl (empty body or 403), try with a browser-like User-Agent:

curl -s -A "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36" "{BLOG_URL}" -o /tmp/feed_fix_live.html

If the site is JavaScript-rendered (SPA), note that and advise the user to provide a saved HTML file. Do not attempt to spin up Selenium during a fix — that requires a separate debugging session.

Step 3: Diagnose the broken selectors

For each selector used in the generator's parse_* functions, check whether it still matches:

python3 -c "
import sys
sys.path.insert(0, 'feed_generators')
from bs4 import BeautifulSoup

with open('/tmp/feed_fix_live.html') as f:
    soup = BeautifulSoup(f.read(), 'html.parser')

# Test each selector from the generator
selectors = [
    'article.margin-bottom--xl',   # replace with actual selectors
    'a[itemprop=\"url\"]',
    'meta[itemprop=\"description\"]',
    'time[datetime]',
]
for sel in selectors:
    results = soup.select(sel)
    print(f'{len(results):4d} matches  {sel}')
"