Feed Diet
Verified@tkuehnl
npx machina-cli add skill @tkuehnl/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
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
- Step 1: Choose your data source (HN username or OPML file).
- Step 2: Fetch, classify, and generate the report with the feed-diet.sh workflow.
- 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.