hackernewslisted

# Hacker News Browse Hacker News in the terminal. A bundled Python script (`scripts/hn.py`, standard library only — no install) does the fetching and formats results as Markdown; your job is to map what the user asked for to the right command, run it, and present the output. `<SKILL_DIR>` below is the directory containing this `SKILL.md` — substitute its absolute path when running. ## Commands ``` # List a feed (default: top, 10 stories). Feeds: top, new, best, ask, show, job python3 <SKILL_DIR>/scripts/hn.py list [feed] -n <count> # Show a story's comment thread (needs the numeric id from a listing) python3 <SKILL_DIR>/scripts/hn.py comments <id> -n <top-level> -d <max-depth> # Search stories via Algolia (--sort date for newest-first instead of relevance) python3 <SKILL_DIR>/scripts/hn.py search "<query>" -n <count> [--sort date] ``` Every command takes `--json` if you need structured data instead of Markdown (e.g. the user wants you to filter, rank, or summarize rather than just list). ## Mapping requests to commands The default — bare `/hackernews`, "what's on HN", "top stories" — is `list` with the default top feed and 10 stories. Honor an explicit count ("top 25", "show me 30") with `-n`. Map feed words directly: "new" / "newest" → `new`, "best" → `best`, "Ask HN" → `ask`, "Show HN" → `show`, "jobs" / "who's hiring" → `job`. "Read the comments on #3" / "open that thread" / "what are people saying about the SpaceX one" → `comments <id>`, using the id shown in th