Skill — source.read_stream

Intent

Fetch new items from a configured source using official APIs where possible; otherwise read via Playwright.

Inputs

source_request:
  platform: enum [reddit, github, forum_web]
  source_id: string
  cursor: string|null
  time_window: duration
  max_items: int

Outputs

raw_items:
  - platform: string
    source_id: string
    permalink: string
    author: string|null
    created_at: iso8601|null
    raw_text: string

Tools

• reddit.list_new_posts
• reddit.list_new_comments
• github.list_issues
• github.list_issue_comments
• playwright.navigate
• playwright.get_content
• playwright.query_selector_all

Policy

• Prefer official APIs over scraping.
• Read-only: never post or reply.
• Do not bypass protections or use stealth tooling.
• Return raw text and minimal metadata only.

Failure Modes

• API/network errors: return error and allow orchestrator backoff.
• Empty results: return empty list with cursor unchanged.