Initial skills documentation — 25 categories, all SKILL.md + references + scripts

skills/devops/ops-portal-and-collector/references/daily-feed-summary-known-limitations.md

@@ -0,0 +1,29 @@
+# Daily Feed Summary — Known Limitations
+
+Repository file: `/root/.hermes/scripts/daily-feed-summary.py`
+Cron job: `daily-tech-digest` (11:00 daily via Hermes cron)
+
+## Broken Sources
+
+### Top Gear (`topgear.com/car-news`)
+- **Status:** [BROKEN] Scraping returns 0 articles
+- **Symptom:** The `TGLinkParser` finds no matching `<a href="/car-news/">` elements
+- **Likely cause:** Site structure changed — Top Gear uses a JS-heavy frontend (Next.js or similar) that renders article links dynamically. The current parser relies on finding `<a href="/car-news/...">` with a `title` attribute in the initial HTML, which no longer exists
+- **Impact:** Minor — Top Gear returns 0 articles silently. The digest continues without error
+- **Discovered:** Jul 6, 2026 (first documented failure)
+- **Fix required:** Switch to headless browser scraping (Playwright) or use an RSS/compat feed if available. LATER: Monitor if Top Gear adds RSS
+
+## Python Dependencies
+
+The script needs `feedparser` in the Hermes venv. See the SKILL.md "Hermes Cron Script Dependencies" section for install patterns.
+
+## Verifying Full Output
+
+```bash
+/root/hermes-assistant/venv/bin/python3 /root/.hermes/scripts/daily-feed-summary.py
+```
+
+For email delivery:
+```bash
+/root/hermes-assistant/venv/bin/python3 /root/.hermes/scripts/daily-feed-summary.py --email
+```