Get the FREE Ultimate OpenClaw Setup Guide →
T

Feed Diet

Verified

@tkuehnl

npx machina-cli add skill @tkuehnl/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://clawhub.ai/tkuehnl/feed-dietView on GitHub

Overview

Feed Diet audits what you actually read from Hacker News and RSS feeds and renders a gorgeous Markdown report. It includes category breakdowns, ASCII charts, and personalized recommendations to help you optimize your information intake.

How This Skill Works

When activated, you choose a data source (HN username or OPML RSS file), fetch content with the dedicated scripts, and classify items using an LLM-powered classifier (falling back to keyword matching if API keys are unavailable). The final step generates a full Markdown report with visualizations that you can render directly.

When to Use It

  • Audit a Hacker News or RSS reading habit to see what you actually consume.
  • Generate a weekly digest filtered by your goals (e.g., systems programming, distributed systems).
  • Visualize consumption with category breakdowns and ASCII charts to identify over- or under-represented areas.
  • Create a screenshot-worthy report to share with teammates or collaborators.
  • Iterate by adjusting your subscriptions based on the report's recommendations.

Quick Start

  1. Step 1: Choose your data source (HN username or OPML file).
  2. Step 2: Fetch, classify, and generate the report with the feed-diet.sh workflow.
  3. Step 3: View the Markdown report and adjust your feeds based on recommendations.

Best Practices

  • Use a known data source: HN username or OPML file to ensure complete coverage.
  • Set a reasonable item limit (e.g., 50–100) for a focused audit.
  • Provide an API key to enable the LLM classifier for higher accuracy; otherwise rely on keyword matching.
  • Review the report's category breakdown and recommendations before adjusting feeds.
  • Leverage Digest Mode for weekly goal-driven reading lists.

Example Use Cases

  • Audit a Hacker News user to reveal top categories and surprising findings.
  • Parse an OPML file of RSS subscriptions and compare topic distribution across feeds.
  • Run a weekly digest filtered to goals such as systems programming and distributed systems.
  • Generate a report to share with your team showing reduced noise and better signal.
  • Use the ASCII charts in the report to visualize shifts in reading focus over time.

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers