What input does user provide?
├── URL (blog, RSS, Reddit, GitHub) → discovery mode
├── Topic/description ("soccer news", "AI weekly") → conversational mode
├── Template name ("reddit-digest", "rss-readability") → template mode
├── Existing feed ID to modify → error (use edit, not create)
└── No input → ask "what kind of feed?"

Given URL, what source type?
├── URL matches reddit.com/r/* → reddit
├── URL contains /feed.xml, /rss, /atom → rss
├── URL matches github.com/*/*/issues → github
├── HTML page with <link rel="alternate" type="application/rss+xml"> → rss
├── Blog with archive page → rss (discover feed URL)
└── Unknown → fallback to generic URL scraper

1. ask-deep to gather intent
   ├── "What content do you want?" (topic, sources)
   ├── "How often?" (daily, weekly)
   ├── "What style?" (narrative, technical, minimal)
   └── "Any special features?" (threads, code highlighting)

2. infer source type
   ├── topic keywords → search for RSS feeds
   ├── subreddit mention → reddit source
   ├── GitHub repo → github issues/PRs

3. select template
   ├── matches reddit patterns → reddit_digest
   ├── mentions code/tech → rss_readability + technical profile
   └── default → minimal with narrative style

4. generate config
   ├── fill required: id, source
   ├── add style profile
   ├── set select params (since, max_items)
   └── validate with zod schema

5. preview and confirm
   ├── show generated YAML
   ├── ask "looks good?"
   └── save or iterate

1. list available templates
   ├── reddit_digest - subreddit digests with comments
   ├── rss_readability - blog/RSS with content extraction
   ├── technical_weekly - engineering feeds with syntax highlighting
   └── minimal - basic RSS subscription

2. prompt for customization
   ├── template has placeholders ({{subreddit}}, {{url}})
   ├── ask for values
   └── optional: style override

3. generate from template
   ├── load template YAML
   ├── substitute placeholders
   ├── validate schema
   └── preview

4. save
   ├── write to ~/.epub/feeds/{id}.yaml
   ├── update feed registry
   └── output: "Feed created: {id}"

1. fetch URL
   ├── check for RSS autodiscovery
   ├── parse HTML for feed links
   └── detect source type (reddit, github, blog)

2. extract metadata
   ├── title, description
   ├── author (if blog)
   ├── update frequency (guess from archive)
   └── content type (technical, narrative)

3. generate config
   ├── choose template based on detected type
   ├── fill source config
   ├── infer style profile from content
   └── set defaults (since: 48h, max_items: 25)

4. validate and preview
   ├── zod schema validation
   ├── show YAML
   └── confirm or customize

version: 1
feeds:
  - id: hn
    sources:
      - https://hnrss.org/frontpage

version: 1
templates:
  reddit_digest:
    select: { since: 24h, max_items: 20 }
    digest: { include_comments: top_3, group_by: flair }

feeds:
  - id: reddit-{{subreddit}}-digest
    extends: [reddit_digest]
    source: { type: reddit, subreddit: {{subreddit}} }

version: 1
feeds:
  - id: {{slug}}
    source: {{rss_url}}
    style:
      profile: technical
      features: { syntax_highlighting: auto }
    select: { since: 7d, max_items: 40 }

Before saving:
├── zod schema validation PASS → continue
├── id is unique (check ~/.epub/feeds/) → continue
├── source URL reachable → continue
├── style profile exists (if specified) → continue
└── Any fail → show error, offer fixes

# Validate generated config
epub feed validate ~/.epub/feeds/new-feed.yaml

# Test fetch without saving
epub feed test new-feed.yaml --dry-run

# List available templates
epub feed templates

# Load template from reference bank
agents reference show reddit-digest --format yaml

# Save generated config as reference
agents reference save --type feed --name custom-digest

# Conversational intake
# ask-deep runs in explore mode to gather:
# - content topic/sources
# - frequency (daily/weekly)
# - style preferences
# - special features

~/.epub/feeds/
├── reddit-soccer-digest.yaml
├── engineering-weekly.yaml
└── custom/
    └── personal-blogs.yaml

~/.claude/skills/feed-create/
├── SKILL.md
├── references/
│   ├── templates.md          # available templates
│   ├── source-detection.md   # URL → source type rules
│   ├── config-patterns.md    # common config recipes
│   └── validation.md         # schema + gates
├── scripts/
│   ├── discover-feed.sh      # URL → feed metadata
│   ├── validate-config.sh    # zod schema check
│   └── list-templates.sh     # show available templates
└── assets/
    └── templates/
        ├── reddit-digest.yaml
        ├── rss-readability.yaml
        ├── technical-weekly.yaml
        └── minimal.yaml

#!/bin/bash
# Discover feed metadata from URL
URL="$1"
curl -sL "$URL" | rg '<link.*alternate.*rss' | head -1

#!/bin/bash
# Validate feed config with zod schema
YAML_FILE="$1"
cd ~/Developer/utils/epub
bun run -e "
import { validateFeedConfig } from './schemas/schema.ts';
import { readFileSync } from 'fs';
import { parse } from 'yaml';
const yaml = readFileSync('$YAML_FILE', 'utf8');
const data = parse(yaml);
const result = validateFeedConfig(data);
if (!result.success) {
  console.error(result.error.issues);
  process.exit(1);
}
console.log('✓ Valid feed config');
"