Agent Skills › garrytan/gstack › hackernews-frontpage

hackernews-frontpage

GitHub

抓取 Hacker News 首页前30条故事数据，解析为包含排名、标题、链接、积分和评论数的 JSON 格式输出。

browser-skills/hackernews-frontpage/SKILL.md garrytan/gstack

Trigger Scenarios

需要获取 Hacker News 热门话题列表分析当前 HN 社区关注趋势监控特定文章在 HN 的排名变化

Install

npx skills add garrytan/gstack --skill hackernews-frontpage -g -y

More Options

Non-standard path

npx skills add https://github.com/garrytan/gstack/tree/main/browser-skills/hackernews-frontpage -g -y

Use without installing

npx skills use garrytan/gstack@hackernews-frontpage

指定 Agent (Claude Code)

npx skills add garrytan/gstack --skill hackernews-frontpage -a claude-code -g -y

安装 repo 全部 skill

npx skills add garrytan/gstack --all -g -y

预览 repo 内 skill

npx skills add garrytan/gstack --list

SKILL.md

Frontmatter

{
    "args": [],
    "host": "news.ycombinator.com",
    "name": "hackernews-frontpage",
    "source": "human",
    "trusted": true,
    "version": "1.0.0",
    "triggers": [
        "scrape hacker news frontpage",
        "scrape hn frontpage",
        "get hn top stories",
        "latest hacker news stories"
    ],
    "description": "Scrape the Hacker News front page (titles, points, comment counts)."
}

Hacker News front-page scraper

Scrapes the Hacker News (news.ycombinator.com) front page and returns the top 30 stories as JSON. Each story has its rank, title, link URL, point count, and comment count.

Usage

$ $B skill run hackernews-frontpage
{
  "stories": [
    { "rank": 1, "title": "...", "url": "...", "points": 412, "comments": 87 },
    ...
  ],
  "count": 30
}

How it works

Navigates to https://news.ycombinator.com via the daemon.
Reads the page HTML.
Parses each story row (HN's stable tr.athing structure) into a typed Story record.
Emits a single JSON document on stdout.

Why this is the reference skill

hackernews-frontpage is the smallest interesting browser-skill: no auth, stable HTML, deterministic output, file-fixture-friendly. Every Phase 1 component (SDK, scoped tokens, three-tier lookup, spawn lifecycle) is exercised by $B skill run hackernews-frontpage and the bundled script.test.ts.

When the HN HTML rotates and our selectors break, the test fails against the captured fixture before users notice. That's the point.

Version History

a325940 Current 2026-07-25 11:04

Metadata

Files: 0
Version: 28d59ad
Hash: 1a4e91d0
Indexed: 2026-07-25 11:04

hackernews-frontpage