Hackernews frontpage

Skill nota-america/forgecat-agent-profiles/profiles/garrytan/gstack/for-codex/.agents/skills/garrytan_gstack/browser-skills/hackernews-frontpage

Scrape the Hacker News front page (titles, points, comment counts).From its SKILL.md

Install

npx -y skills add nota-america/forgecat-agent-profiles --skill hackernews-frontpage

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

1.4 KB, 297 tokens by cl100k_base, as published. Nobody here has run it

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.

What ships with it: 4 files

24.6 KB alongside SKILL.md, 3 of them executable

_lib/

browse-client.tsruns11.3 KB

fixtures/

hn-2026-04-26.html5.0 KB

script.test.tsruns3.8 KB
script.tsruns4.6 KB