Skip to content
cccskills
FreePublished on GitHubEnglish overview

hackernews-frontpage

Retrieve the top 30 stories from the Hacker News front page as JSON, a structured data format. Each entry includes its rank, title, link, points, and comment count for reviewing stories and their engagement.

OriginalShow the original description

Scrape the Hacker News front page (titles, points, comment counts).

AI rating90/ 100See how to install

Good for

  • Review the top 30 Hacker News stories
  • Compare story points and comment counts
  • Collect article titles and links
  • Obtain front-page stories as structured JSON

Overview

What it does

hackernews-frontpage retrieves the top 30 stories from the Hacker News front page and returns them as JSON, a structured data format. Each story includes its rank, title, link URL, points, and comment count. The story list and the number of retrieved entries are combined in one result, so you can review both the front-page content and the responses to individual stories from the same data.

When it helps

Use it to check which stories are currently on the Hacker News front page or to compare their points and comment counts. It also helps when you want to collect titles and links together, or receive the list as JSON for further processing.

Example requests

  • “Retrieve 30 stories from the Hacker News front page.”
  • “Return the top stories’ titles, links, points, and comment counts as JSON.”

Notes

Execution uses $B skill run hackernews-frontpage and an environment with the browser automation daemon described in the material. No login is required. The scope is the front page, and retrieval depends on parsing its HTML structure. Changes to the site’s structure may therefore affect retrieval.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Objective evaluation

AI rated this skill on four points using only the contents of its SKILL.md. Stars and popularity are not taken into account.

Clear instructionsIs it clear when to use it and what it does?
AGoodIt explicitly retrieves the top 30 Hacker News stories and returns ranks and engagement counts as JSON.
Concrete stepsAre steps, inputs, outputs, and examples spelled out?
AGoodIt includes the execution command, four retrieval and parsing steps, and an output example containing stories and count.
SafetyAre sending data, deleting files, and running commands disclosed?
AGoodThe documented operations read and parse a public page and return data on stdout; authentication is not required.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingIt requires $B and a browser automation daemon, but does not provide installation instructions for them.

The total counts each point as A = 25, B = 15, C = 5. Rated by AI (OpenAI Codex) as of Oct 20, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (5)

  • SKILL.md1.4 KB
  • _lib/browse-client.ts11.3 KB
  • fixtures/hn-2026-04-26.html5.0 KB
  • script.test.ts3.8 KB
  • script.ts4.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

autoplan

FreeSummaryAI rating 80

Run sequential reviews of a plan from business, design, engineering, and developer experience perspectives. Apply six principles to intermediate decisions, then bring close choices, scope questions, and reviewer disagreements to a final approval step.

  • Reviewing a plan from several perspectives
  • Running reviews without answering every intermediate question
  • Considering close choices and disagreements at final approval
garrytan/gstack137KUpdated Oct 19, 2026

benchmark

FreeSummaryAI rating 80

Measure web page loading times, rendering milestones, and resource sizes in a real browser. Save baseline measurements, compare results before and after code changes, and inspect historical trends to spot performance regressions.

  • Saving performance baselines before changes
  • Checking page speed after a code change
  • Finding slow resources and large transfers
garrytan/gstack137KUpdated Oct 19, 2026

benchmark-models

FreeSummaryAI rating 70

Compare Claude, GPT, and Gemini on the same skill or prompt. Get a table of response times, token usage, and costs, with optional AI scoring to help choose a model for the task.

  • Choosing a model for a specific skill
  • Comparing response times and costs
  • Comparing output quality with optional AI scoring
garrytan/gstack137KUpdated Oct 19, 2026

browse

FreeSummaryAI rating 70

Open web pages, follow navigation, and check form flows in a browser. Capture screenshots at different screen sizes, compare pages before and after actions, and collect console errors, the technical messages that can reveal page problems.

  • Checking navigation and form flows
  • Capturing mobile, tablet, and desktop views
  • Recording screenshots and console errors
garrytan/gstack137KUpdated Oct 19, 2026

canary

FreeSummaryAI rating 70

Monitor a live app after deployment for console errors, slower performance, and page failures. Periodic screenshots and comparisons with pre-deployment baselines help identify anomalies and check whether the release is behaving as expected.

  • Monitoring a live app after deployment
  • Checking for performance regressions after a release
  • Comparing screenshots before and after deployment
garrytan/gstack137KUpdated Oct 19, 2026

careful

FreeSummaryAI rating 90

Check shell commands before they run and warn about destructive actions such as file deletion, database removal, and Git history changes. Users can approve ordinary warnings, while certain catastrophic command patterns are denied.

  • Check destructive commands in production
  • Review deletion commands in shared environments
  • Catch Git operations that discard work
garrytan/gstack137KUpdated Oct 19, 2026

See all skills by garrytan

Report a problem with this skill