# Feed Diet

> Audit your information diet across HN and RSS feeds — beautiful reports with category breakdowns, ASCII charts, and personalized recommendations.

- **Type:** Skill
- **Install:** `agentstack add skill-cacheforge-ai-cacheforge-skills-feed-diet`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [cacheforge-ai](https://agentstack.voostack.com/s/cacheforge-ai)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [cacheforge-ai](https://github.com/cacheforge-ai)
- **Source:** https://github.com/cacheforge-ai/cacheforge-skills/tree/main/skills/feed-diet
- **Website:** https://clawhub.com

## Install

```sh
agentstack add skill-cacheforge-ai-cacheforge-skills-feed-diet
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🍽️ 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:
   ```bash
   # 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:
   ```bash
   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
   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
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 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
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
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
bash "$SKILL_DIR/scripts/feed-diet.sh" audit --opml /path/to/feeds.opml
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [cacheforge-ai](https://github.com/cacheforge-ai)
- **Source:** [cacheforge-ai/cacheforge-skills](https://github.com/cacheforge-ai/cacheforge-skills)
- **License:** MIT
- **Homepage:** https://clawhub.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-cacheforge-ai-cacheforge-skills-feed-diet
- Seller: https://agentstack.voostack.com/s/cacheforge-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.