What it does. Scrape the Hacker News front page (titles, points, comment counts). Part of garrytan/gstack (Garry Tan's Claude Code skill suite) (garrytan/gstack).

Install

• git clone https://github.com/garrytan/gstack ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup installs the whole suite; npx skills add garrytan/gstack --skill hackernews-frontpage copies just this skill (many gstack skills call the shared bin/ and browse daemon, so prefer the full install).
• Raw file: curl -sL https://raw.githubusercontent.com/garrytan/gstack/HEAD/browser-skills/hackernews-frontpage/SKILL.md

SKILL.md (verbatim)

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

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

1. Navigates to https://news.ycombinator.com via the daemon.
2. Reads the page HTML.
3. Parses each story row (HN's stable tr.athing structure) into a typed Story record.
4. 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.

Other files in this skill

• _lib/browse-client.ts
• fixtures/hn-2026-04-26.html
• script.test.ts
• script.ts

Back to garrytan/gstack (Garry Tan's Claude Code skill suite) or Agent skills.