---
name: "feedparser-rss-atom-pipeline"
description: "Parse, normalize, and extract articles from diverse RSS and Atom syndication feeds."
metadata:
  author: "Kurt McKee"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "parse rss feed python"
  - "extract atom feed entries"
  - "normalize rss publication dates"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# feedparser Python RSS & Atom Feed Normalizer

Processes syndication feeds using Python feedparser: handling inconsistent date formats, extracting author metadata, parsing enclosures/podcasts, and sanitizing embedded HTML content.

## When to Invoke
Invoke this skill whenever you need to:
- parse rss feed python
- extract atom feed entries
- normalize rss publication dates

## Execution SOP & Rules
1. Parse feed URLs or XML strings with feed = feedparser.parse(url_or_xml).
2. Iterate over articles with for entry in feed.entries: title = entry.title.
3. Convert publication timestamps cleanly with datetime.fromtimestamp(mktime(entry.published_parsed)).
4. Verify HTTP ETag and Last-Modified headers to poll only updated feeds without waste.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.
