Agent skill

Hacker News Summarizer

by ykdojo in ykdojo/claude-code-tips

Fetches Hacker News top stories, a chosen story with its comment thread and the linked article through the official APIs, then summarizes them.

Custom licenceAuto-check passedWriting & Content

Install Hacker News Summarizer

skills CLI
$ npx skills add ykdojo/claude-code-tips --skill hn-summarize -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ykdojo/claude-code-tips hn-summarize --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ykdojo/claude-code-tips.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hn-summarize .claude/skills/hn-summarize && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hn-summarize
GitHub stars
10k
Token cost
~942 tokens
SKILL.md length
306 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
Custom licence

At a glance

Fetches Hacker News top stories, a chosen story with its comment thread and the linked article through the official APIs, then summarizes them.

  • Works in 4 steps: Current top stories (the "top 10") → Find a specific story by topic (Algolia… → Fetch a story + its comment tree → …
  • Summarizing the current Hacker News front page
  • SKILL.md covers 1. Current top stories (the…, 2. Find a specific story by…, 3. Fetch a story + its comment… and 4. Fetch the linked article, plus 1 more section
  • Calls curl and python3; reaches hacker-news.firebaseio.com and hn.algolia.com

What it does

The hckrnews.com front end is rendered with JavaScript, so fetching it returns an empty shell and the skill says not to scrape it. It uses the official Hacker News Firebase and Algolia APIs instead, which return plain JSON with points, comment counts and full comment trees. The current top stories come from `topstories.json`, which lists 500 story IDs in front-page order, and the agent takes the first N and looks up each item.

To find a specific story, the agent searches Algolia by topic, optionally filtering by a recent timestamp to avoid old duplicates, and picks the match with the most points and comments. It then fetches the item's nested comment tree and prints root comments in thread order, since per-comment points are now always null. The linked article is fetched with `curl`, stripped to readable text, and a Wayback Machine snapshot is the fallback for JavaScript-heavy or paywalled pages.

When your agent uses it

  • Summarizing the current Hacker News front page
  • Reading a specific HN story together with its discussion
  • Pulling the top few stories from hckrnews
  • Reading an article that blocks direct fetches by using an archived snapshot

Example prompts

  • “Summarize the top 10 stories on Hacker News right now.”
  • “Find the HN discussion about the latest Rust release and summarize the main arguments in the comments.”
  • “Summarize that Hacker News story plus its top comment threads, and fetch the linked article too.”
  • “Give me the top 5 from hckrnews with a one-line summary of each discussion.”

Requirements

  • Network access to the Hacker News and Algolia APIs
  • `curl` and Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Current top stories (the "top 10")
  2. Find a specific story by topic (Algolia search)
  3. Fetch a story + its comment tree
  4. Fetch the linked article

What it can do on your machine

Read from SKILL.md and the folder at commit 577ac89. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • hacker-news.firebaseio.com
    • hn.algolia.com
    • archive.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hacker News Summarizer loads about 942 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 306 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~942

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 306 words (~942 tokens).

“hckrnews.com is a JavaScript-rendered front end - curling it returns an empty shell, so do not scrape it. Instead use the official Hacker News APIs (Firebase + Algolia), which give the same stories with points, comment counts, and full comment…”

— opening of SKILL.md by ykdojo, Custom licence
name
hn-summarize

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/hn-summarize of ykdojo/claude-code-tips.

Open the folder on GitHubat commit 577ac89

Compare with similar skills

Hacker News Summarizer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hacker News Summarizer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hacker News Summarizer this skillykdojo/claude-code-tips10k—~942Automated safety check: PassCustom licence
AIHOT AI News LookupKKKKhazix/khazix-skills21k—~461Automated safety check: PassMIT
What Happenedkunchenguid/whathappened231—~2.1kAutomated safety check: PassMIT
Hacker News Searchdylanfeltus/skills179—~1.7kAutomated safety check: PassMIT
YouTube TranscriptAPIZeroPointRepo/youtube-skills1k1 repos~3kAutomated safety check: PassMIT
Aqua Evaluationoracle/accelerated-data-science125—~1.6kAutomated safety check: PassUPL-1.0

Similar skills

  • AIHOT AI News Lookup

    KKKKhazix/khazix-skills

    Answers questions about recent AI news by querying AIHOT's Chinese-language agent API live, covering daily highlights, search, hot events and the daily digest.

    21k GitHub stars~461 tokensUpdated 8 days ago
    Productivity & AutomationAuto-check passed
  • What Happened

    kunchenguid/whathappened

    Briefs you on what just happened around a named topic and maps public opinion on X, using the host's native X search tools only.

    231 GitHub stars~2.1k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Hacker News Search

    dylanfeltus/skills

    Searches and monitors Hacker News stories, comments and users through the free Algolia HN Search API, with tag, points and date filters.

    179 GitHub stars~1.7k tokensUpdated 22 days ago
    Productivity & AutomationAuto-check passed
  • YouTube TranscriptAPI

    ZeroPointRepo/youtube-skills

    Pulls YouTube transcripts, searches videos and channels and browses playlists through the TranscriptAPI service with a single API key.

    1k GitHub starsUsed in 1 repo~3k tokens
    Knowledge ManagementAuto-check passed
  • Aqua Evaluation

    oracle/accelerated-data-science

    Official

    Evaluate LLM model quality using BERTScore, ROUGE, Perplexity, and Text Readability metrics on OCI AI Quick Actions (AQUA).

    125 GitHub stars~1.6k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Web Importer

    wpsnote/wpsnote-skills

    将网页内容高质量导入到 WPS 笔记,保留原文颜色、粗体、标题格式,图片按原文位置插入. An agent skill from wpsnote/wpsnote-skills.

    179 GitHub stars~964 tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed

More from ykdojo/claude-code-tips

All 9 skills in this repo
  • Reddit JSON Fetcher

    ykdojo/claude-code-tips

    Fetches Reddit posts, threads and search results as JSON through a browser session, using a DuckDuckGo redirect to get past Reddit's automated-access block.

    10k GitHub stars~1.4k tokensUpdated 15 days ago
    Auto-check passed
  • Claude Code Version Check

    ykdojo/claude-code-tips

    Recommends whether to stay on the installed Claude Code version, update, or pin another one by comparing npm tags, release timing and the changelog.

    10k GitHub stars~1.8k tokensUpdated 15 days ago
    Auto-check passed
  • Private GitHub Repo Search

    ykdojo/claude-code-tips

    Full-text searches across every one of the user's GitHub repos, including private ones, using a local mirror and ripgrep instead of GitHub's own search.

    10k GitHub stars~444 tokensUpdated 15 days ago
    Auto-check passed
  • CLAUDE.md Review

    ykdojo/claude-code-tips

    Mines your recent Claude Code conversations for rules that were broken, missing or stale, and suggests edits to global and project CLAUDE.md files.

    10k GitHub stars~677 tokensUpdated 15 days ago
    Auto-check passed
  • Conversation Half-Clone

    ykdojo/claude-code-tips

    Clones only the later half of the current Claude Code session into a fresh one, cutting token usage while keeping the recent work intact.

    10k GitHub stars~372 tokensUpdated 15 days ago
    Auto-check passed
  • Quarter Clone Conversation

    ykdojo/claude-code-tips

    Starts a new Claude Code session from only the last quarter of the current conversation, dropping earlier context to save tokens while keeping recent work.

    10k GitHub stars~401 tokensUpdated 15 days ago
    Auto-check passed

Works with

Questions about Hacker News Summarizer

What does Hacker News Summarizer do?

Fetches Hacker News top stories, a chosen story with its comment thread and the linked article through the official APIs, then summarizes them. com front end is rendered with JavaScript, so fetching it returns an empty shell and the skill says not to scrape it. It uses the official Hacker News Firebase and Algolia APIs instead, which return plain JSON with points, comment counts and full comment trees.

When should I use Hacker News Summarizer?

Hacker News Summarizer fits situations like: summarizing the current Hacker News front page; reading a specific HN story together with its discussion; pulling the top few stories from hckrnews; reading an article that blocks direct fetches by using an archived snapshot.

How do I install Hacker News Summarizer in Claude Code?

Run `npx skills add ykdojo/claude-code-tips --skill hn-summarize -a claude-code`. Or copy the skill folder (skills/hn-summarize in ykdojo/claude-code-tips) into .claude/skills/hn-summarize in your project. Claude Code loads it when a task matches its description.

How do I install Hacker News Summarizer in Codex?

Run `npx skills add ykdojo/claude-code-tips --skill hn-summarize -a codex`. Or copy the skill folder (skills/hn-summarize in ykdojo/claude-code-tips) into .agents/skills/hn-summarize in your project. Codex loads it when a task matches its description.

Can I use Hacker News Summarizer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ykdojo/claude-code-tips --skill hn-summarize -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hn-summarize, .gemini/skills/hn-summarize, .github/skills/hn-summarize and .opencode/skills/hn-summarize in your project.

What does Hacker News Summarizer need to run?

Going by SKILL.md and its folder, Hacker News Summarizer needs the command-line tools its instructions call (curl and python3). Our summary lists: Network access to the Hacker News and Algolia APIs; `curl` and Python 3.

Does Hacker News Summarizer access the network?

SKILL.md names 3 domains. In commands or code: hacker-news.firebaseio.com, hn.algolia.com and archive.org; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Hacker News Summarizer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hacker News Summarizer use?

Hacker News Summarizer has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Hacker News Summarizer use?

About 942 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Hacker News Summarizer?

Skills that share tags, products or a category with Hacker News Summarizer: AIHOT AI News Lookup (KKKKhazix/khazix-skills, 21k stars), What Happened (kunchenguid/whathappened, 231 stars), Hacker News Search (dylanfeltus/skills, 179 stars) and YouTube TranscriptAPI (ZeroPointRepo/youtube-skills, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hacker News Summarizer?

ykdojo (a GitHub user) maintains it in ykdojo/claude-code-tips, which has 10,202 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on September 25, 2026.

Source: ykdojo/claude-code-tips on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.