Agent Skills
› mohitagw15856/pm-claude-skills
› hn-digest
hn-digest
GitHub该技能用于生成 Hacker News 的精选摘要，而非罗列原始标题。通过 Firebase 和 Algolia API 获取数据，提供热门故事概览、特定故事的讨论论点梳理及话题搜索，并输出可复现的 curl 命令。
触发场景
询问当前 Hacker News 热点内容
要求总结今日 HN 动态
查询某篇具体文章的讨论观点
搜索 HN 是否报道过特定主题
安装
npx skills add mohitagw15856/pm-claude-skills --skill hn-digest -g -y
SKILL.md
Frontmatter
{
"name": "hn-digest",
"homepage": "https:\/\/mohitagw15856.github.io\/pm-claude-skills\/skill\/hn-digest.html",
"metadata": {
"openclaw": {
"emoji": "🧠"
}
},
"description": "Pull the current Hacker News front page, top comments, or a topic search with zero API keys — the official Firebase API and Algolia search via curl, digested instead of dumped. Use when asked what's on Hacker News, summarize HN today, what's the discussion on this story, or has HN covered some topic. Produces a ranked digest with scores and comment counts, the discussion's actual argument threads when asked, and the rerunnable commands."
}
HN Digest Skill
"What's on HN?" deserves better than thirty raw titles — the value is in the digest: what's leading, what the comment sections are actually arguing, and which of it the user cares about. Hacker News serves everything keylessly twice over: the official Firebase API (live items by id) and Algolia's HN search (query, date ranges, popularity). This skill knows when to use which, batches sanely, and summarizes discussions as positions, not vibes.
What This Skill Produces
- The digest — top stories with score, comments count, domain, and a one-line what-it-is
- Discussion reads — for a story: the top comment threads compressed into the actual arguments being made
- Topic searches — has-HN-covered-X, with dates and reception
- The commands — exact curls, rerunnable
Required Inputs
Ask for these if not provided:
- The mode — front page now, a specific story's discussion, or a topic search
- Appetite — top 5 headline-digest vs. deep read of one thread
- Their filter — "anything about AI/security/startups" turns a digest into a targeted one; worth asking when the user has an obvious beat
Framework: The Two APIs and the Digest Rules
- Front page (official API): ids:
curl -s "https://hacker-news.firebaseio.com/v0/topstories.json"→ then per itemcurl -s "https://hacker-news.firebaseio.com/v0/item/{id}.json"→title,score,descendants(comment count),url,by,time. Fetch the top 10–15 ids only — not all 500. Also:beststories,newstories,askstories,showstories. - Search and story lookup (Algolia):
curl -s "https://hn.algolia.com/api/v1/search?query=postgres&tags=story&numericFilters=points>50"— or by date:search_by_date. A story's full comment tree in one call:https://hn.algolia.com/api/v1/items/{id}. For topic questions Algolia is one request where Firebase is fifty. - Digest, don't dump: each story gets one line of what-it-actually-is (from the title and domain — fetch the linked article only if the user asks); lead with the 3–5 highest-signal items for the user's stated interests, then the rest compressed.
- Comment sections are position maps: summarize a discussion as its distinct arguments ("top thread argues X; the main pushback says Y; a practitioner reports Z") with rough weight — never as "mixed reactions," which is always true and never informative. Attribute claims to "a commenter," not as facts.
- Freshness and voice: scores are moving snapshots — timestamp the digest; and HN comments are opinions with usernames, quoted as such. The front page is also a specific community's taste — say "HN's take" not "the tech world's take."
Output Format
HN Digest — [time, user's zone]
[If filtered: the matching stories first.]
| # | Story | Score · Comments | What it is |
|---|
[Discussion mode: the position map — 3–5 argument threads, weighted, attributed] [Search mode: matches with dates and reception]
Source: [HN Firebase API / Algolia HN search] · rerun: [exact curls]
Scores are live snapshots; comments are commenters' views, not facts.
Quality Checks
- Fetches were batched sanely (top 10–15, not 500 ids)
- Every story line says what the thing is, not just its title
- Discussion summaries name distinct positions with rough weights — no "mixed reactions"
- Comment claims are attributed, not laundered into facts
- The digest is timestamped
Anti-Patterns
- Do not dump 30 raw titles — the digest is the product
- Do not loop the Firebase API when Algolia answers in one call
- Do not present commenter claims as verified facts — attribute or drop
- Do not answer "what's on HN" from memory — the front page turns over in hours
- Do not editorialize the community's votes into objective importance — it's HN's taste, labeled as such
版本历史
- 54fad50 当前 2026-07-19 12:21
