← Browse

@browsing-skills/browsing-hackernews

A

Use when the user wants to interact with Hacker News (news.ycombinator.com) — read top stories from the frontpage, extract a post's data and comments, or search stories via the Algolia HN search API. No authentication required. HN uses server-rendered HTML, so extraction works reliably without a browser (though a browser still works fine).

skillclaude

Install

agr install @browsing-skills/browsing-hackernews --target claude

Writes 1 file into .claude/skills/, pinned to git-18fd812e.

  • .claude/skills/browsing-hackernews/SKILL.md

Document


name: browsing-hackernews description: "Use when the user wants to interact with Hacker News (news.ycombinator.com) — read top stories from the frontpage, extract a post's data and comments, or search stories via the Algolia HN search API. No authentication required. HN uses server-rendered HTML, so extraction works reliably without a browser (though a browser still works fine)."

Hacker News — Browsing Skill

Use this index to choose the HN action that matches the user request, then open the linked reference file for the complete navigation, requirements, code, and return shape.

Action Index

  • frontpage — Extract top stories from the HN frontpage (rank, title, URL, score, author, comment count). Supports pagination. Full spec: references/frontpage.md.
  • post-data — Extract a specific post's details (title, URL, score, author, age) and its top-level comments. Full spec: references/post-data.md.
  • search — Search Hacker News stories via the Algolia HN API. No browser navigation required — calls the API via fetch. Full spec: references/search.md.

Benchmarks

Benchmarks compare the maintained skill action against a no-skill browser agent that inspects the live page DOM and derives selectors at runtime. Full notes live in BENCHMARKS.md.

ActionWith SkillWithout SkillNotes
frontpageTBDTBDTBD
post-dataTBDTBDTBD
searchTBDTBDTBD

Trustgrade A

  • passBody integrity

    Whether the stored document is plausibly the kind of file the artifact declares, rather than something fetched by mistake.

  • passType matchnot applicable to this artifact type

    Whether the artifact is really the kind of thing its metadata claims it is.

  • passFreshness

    How long since the source repository was last pushed to.

  • passPrompt injection

    Scans the artifact's own text for instructions aimed at your agent rather than at you.

  • passLicense

    Whether the source repository declares an SPDX license permissive enough to redistribute.

How the grade is calculated

Each check contributes 0 points when it passes, 1 when it warns, and 2 when it fails. The total maps to a letter:

  • Aevery check passed
  • Bone warning
  • Ctwo warnings
  • Dprompt injection or body integrity failed, or three warnings
  • Fone of those failed, and something else is wrong

These are automated hygiene checks, not a security audit, and not a dependency or vulnerability scan. A grade of A means nothing was flagged — not that the artifact is safe.

Versions

  • git-18fd812e7ef02026-07-31