athola Discourse Search
When To Use
- Gathering community opinions on a technology or approach
- Finding experience reports from HN, Reddit, or Lobsters
When NOT To Use
- Academic research (use
Skill(tome:papers)) - Code examples (use
Skill(tome:code-search))
Scan community channels for discussions on a topic.
Channels
- Hacker News: Algolia API at hn.algolia.com
- Lobsters: WebSearch with site:lobste.rs
- Reddit: JSON API (append .json to URLs)
- Tech blogs: WebSearch targeting curated domains
Workflow
- Build search URLs/queries per channel using
tome.channels.discourse.*functions - Execute via WebFetch (APIs) or WebSearch (fallback)
- Parse responses into Finding objects
- Merge across sources with source attribution
Exit Criteria
- At least two community channels (HN, Lobsters, Reddit, or tech blogs) queried per invocation
- HN results fetched via Algolia API at
hn.algolia.com(WebFetch); WebSearch used as fallback if the API is unreachable - Each Finding object includes a
sourcefield identifying which channel (HN, Lobsters, Reddit, or blog) it came from - If all WebFetch and WebSearch calls fail for every channel, the failure is reported explicitly rather than returning fabricated or empty findings