Get the FREE Ultimate OpenClaw Setup Guide β†’
npx machina-cli add skill cacheforge-ai/cacheforge-skills/feed-diet --openclaw
Files (1)
SKILL.md
4.3 KB

🍽️ 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)

  1. 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
  2. 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
    
  3. Classify items. Pipe the fetched items through the classifier:

    cat items.jsonl | bash "$SKILL_DIR/scripts/classify.sh" > classified.jsonl
    

    The classifier uses LLM (if ANTHROPIC_API_KEY or OPENAI_API_KEY is set) or falls back to keyword matching.

  4. Generate the report. Run the main entry point:

    bash "$SKILL_DIR/scripts/feed-diet.sh" audit --hn USERNAME --limit 100
    
  5. 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

CommandDescription
feed-diet audit --hn USERFull diet audit for an HN user
feed-diet audit --opml FILEFull 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 Report
    • Generate Weekly Digest
    • Show 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 point
  • scripts/hn-fetch.sh β€” Hacker News story fetcher
  • scripts/opml-parse.sh β€” OPML/RSS feed parser
  • scripts/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

  1. Step 1: Choose data source (HN username or OPML file path).
  2. Step 2: Fetch and classify content using the provided scripts (hn-fetch.sh or opml-parse.sh; then classify.sh).
  3. 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

Add this skill to your agents

Related Skills

Sponsor this space

Reach thousands of developers β†—