hackernews frontpage
- Repo stars 0
- Author updated Aug 24, 2026, 03:55 PM
- Author repo gstack
- Domain
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 92 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @garrytan · v1.0.0 · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Shell exec
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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.
Sections and files
Listed in source order.
sections -> Usage → How it works → Why this is the reference skill
terms -> Scrapes the Hacker News (news.ycombinator.com) front page and returns the top 30 stories as JSON. · 1. Navigates to https://news.ycombinator.com via the daemon. · hackernews-frontpage is the smallest interesting browser-skill: no auth, stable HTML, deterministic output, file-fixture-friendly. · When the HN HTML rotates and our selectors break, the test fails against the captured fixture before users notice.
files/cmd -> news.ycombinator.com · https://news.ycombinator.com · tr.athing · Story · hackernews-frontpage · $B skill run hackernews-frontpage · script.test.ts
body sha256 -> b59e15f58490
How it works
Navigates to
https://news.ycombinator.comvia the daemon. Reads the page HTML. Parses each story row (HN's stabletr.athingstructure) into a typedStoryrecord. Emits a single JSON document on stdout.Why this is the reference skill
hackernews-frontpageis 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-frontpageand the bundledscript.test.ts.