npx machina-cli add skill cacheforge-ai/cacheforge-skills/feed-diet --openclawπ½οΈ Feed Diet
Audit your information diet and get a gorgeous report showing what you actually consume.
Trigger
Activate when the user mentions any of:
- "feed diet"
- "information diet"
- "audit my feeds"
- "what am I reading"
- "analyze my HN"
- "reading habits"
- "content diet"
- "feed report"
Instructions
Audit Mode (default)
-
Determine the data source. Ask the user for one of:
- A Hacker News username (e.g., "tosh")
- An OPML file path containing RSS feed subscriptions
-
Fetch the content. Run the appropriate fetch script:
# For HN: bash "$SKILL_DIR/scripts/hn-fetch.sh" USERNAME 100 # For OPML: bash "$SKILL_DIR/scripts/opml-parse.sh" /path/to/feeds.opml -
Classify items. Pipe the fetched items through the classifier:
cat items.jsonl | bash "$SKILL_DIR/scripts/classify.sh" > classified.jsonlThe classifier uses LLM (if ANTHROPIC_API_KEY or OPENAI_API_KEY is set) or falls back to keyword matching.
-
Generate the report. Run the main entry point:
bash "$SKILL_DIR/scripts/feed-diet.sh" audit --hn USERNAME --limit 100 -
Present the report to the user. The output is Markdown β render it directly.
Digest Mode (weekly curated reading)
When the user wants a filtered reading list based on their goals:
bash "$SKILL_DIR/scripts/feed-diet.sh" digest --hn USERNAME --goal "systems programming, distributed systems" --days 7
Quick Reference
| Command | Description |
|---|---|
feed-diet audit --hn USER | Full diet audit for an HN user |
feed-diet audit --opml FILE | Full diet audit from RSS feeds |
feed-diet digest --hn USER --goal "X" | Weekly digest filtered by goals |
Notes for the Agent
- Be conversational. After presenting the report, offer observations like "Looks like you're heavy on news β want me to suggest some deeper technical feeds?"
- Suggest the digest mode if the user seems interested in filtering their reading.
- The report is the star. Don't summarize it β present it in full. It's designed to be screenshot-worthy.
- If classification seems off, mention that setting an LLM API key improves accuracy.
Discord v2 Delivery Mode (OpenClaw v2026.2.14+)
When the conversation is happening in a Discord channel:
- Send a compact first summary (top category, diversity score, top 2 recommendations), then ask if the user wants the full report.
- Keep the first response under ~1200 characters and avoid wide category tables in the first message.
- If Discord components are available, include quick actions:
Show Full Diet ReportGenerate Weekly DigestShow Recommendations
- If components are not available, provide the same follow-ups as a numbered list.
- Prefer short follow-up chunks (<=15 lines per message) when sharing long reports.
References
scripts/feed-diet.shβ Main entry pointscripts/hn-fetch.shβ Hacker News story fetcherscripts/opml-parse.shβ OPML/RSS feed parserscripts/classify.shβ Batch content classifier (LLM + fallback)scripts/common.shβ Shared utilities and formatting
Examples
Example 1: HN Audit
User: "Audit my HN reading diet β my username is tosh"
Agent runs:
bash "$SKILL_DIR/scripts/feed-diet.sh" audit --hn tosh --limit 50
Output: A full Markdown report with category breakdown table, top categories with sample items, surprising finds, and recommendations.
Example 2: Weekly Digest
User: "Give me a digest of what's relevant to my work on compilers and programming languages"
Agent runs:
bash "$SKILL_DIR/scripts/feed-diet.sh" digest --hn tosh --goal "compilers, programming languages, parsers" --days 7
Output: A curated reading list of 10-20 items ranked by relevance to the user's goals.
Example 3: RSS Feed Audit
User: "Here's my OPML file, tell me what my feed diet looks like"
Agent runs:
bash "$SKILL_DIR/scripts/feed-diet.sh" audit --opml /path/to/feeds.opml
Source
git clone https://github.com/cacheforge-ai/cacheforge-skills/blob/main/skills/feed-diet/SKILL.mdView on GitHub Overview
Feed Diet audits your information intake across Hacker News and RSS feeds, delivering category breakdowns, ASCII charts, and personalized recommendations. It helps you understand what you actually read and refocus your feeds to align with your goals.
How This Skill Works
Choose a data source (HN username or OPML file), fetch the content with hn-fetch.sh or opml-parse.sh, classify items using the classifier script (with LLM if API keys are set or fallback to keyword matching), and generate a Markdown report via feed-diet.sh. The output is designed to be screenshot-worthy and can include personalized recommendations based on the classification.
When to Use It
- To audit your reading habits from a Hacker News user account (e.g., tosh).
- To audit RSS feed subscriptions by parsing an OPML file and generating a report.
- To receive a weekly, goal-driven digest of your reading list.
- When you want a clear category breakdown with ASCII charts showing your diet.
- When you want higher accuracy by enabling an API key for the classifier.
Quick Start
- Step 1: Choose data source (HN username or OPML file path).
- Step 2: Fetch and classify content using the provided scripts (hn-fetch.sh or opml-parse.sh; then classify.sh).
- Step 3: Generate and view the Markdown report with feed-diet.sh audit or digest.
Best Practices
- Specify a clear data source (HN username or OPML file path) before running.
- Enable ANTHROPIC_API_KEY or OPENAI_API_KEY to maximize classifier accuracy.
- Review the full Markdown report rather than relying on summaries.
- Use digest mode to tailor output to your goals (e.g., systems programming).
- If classification seems off, adjust inputs or try the full audit for a broader view.
Example Use Cases
- Example 1: Audit HN reading diet for user 'tosh' with a 50-item limit to generate a full report.
- Example 2: Weekly digest filtered by goals like 'systems programming, distributed systems' for 7 days.
- Example 3: Audit an OPML file containing multiple RSS feeds to see overall diet composition.
- Example 4: Use digest mode in Discord to share a compact summary first, then the full report.
- Example 5: Run a targeted audit on a specific topic cluster to identify dominant categories.
Frequently Asked Questions
Related Skills
log-analysis
chaterm/terminal-skills
ζ₯εΏεζδΈε€η
hook-factory
alirezarezvani/claude-code-skill-factory
Generate production-ready Claude Code hooks with interactive Q&A, automated installation, and enhanced validation. Supports 10 templates across 7 event types for comprehensive workflow automation.
explain-codebase
suryast/free-ai-agent-skills
Drop into any repo and generate a structured architecture overview. Maps the codebase, identifies entry points, frameworks, and dependencies β then produces a "start here" guide for new contributors.
video-breakdown
wells1137/skills-gen
# Video Breakdown A professional video analysis skill powered by a **dual-model architecture**: ByteDance **Seed-2.0-Mini** for rapid previews and Google **Gemini 2.5 Pro** for deep, cinematic-grade analysis. It provides quantitative quality assessments and meticulous shot-by-shot breakdowns (ζη)
skillsmith
smith-horn/skillsmith
Discover, install, compare, and manage Claude Code skills. Search the registry, get recommendations, validate skill quality, and manage your installed skills.
App Health Monitor
openclaw/skills
Monitor deployed apps for uptime and errors. Checks HTTP status, response times, and sends Discord alerts when something goes down. Includes cron setup for automated monitoring.