← Back to Skills Marketplace
runawaydevil

HN Reader

by runawaydevil · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
404
Downloads
1
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install hn-reader
Description
Monitors and fetches HackerNews stories via official API, supporting top, new, best, Ask, Show, Jobs categories and keyword searches.
README (SKILL.md)

HackerNews Skill

Monitora e busca stories do HackerNews via API oficial.

Gatilhos

Ative a skill usando palavras-chave:

  • "hackernews", "hn" — listar top stories
  • "top stories", "front page" — top stories
  • "new", "latest", "novas" — stories recentes
  • "ask hn", "askstories" — Ask HN
  • "show hn", "showstories" — Show HN
  • "jobs", "vagas" — Jobs
  • "best", "melhores" — Melhores stories
  • "buscar no hn", "pesquisar hn" — buscar por termo

Como Usar

# Listar top stories (padrão: 10)
node index.js top
node index.js top 20

# Stories recentes
node index.js new
node index.js new 15

# Melhores stories
node index.js best

# Ask HN
node index.js ask
node index.js show

# Jobs
node index.js jobs

# Ver detalhes de uma story por ID
node index.js item 12345678

# Ver perfil de usuário
node index.js user pg

# Buscar stories por termo
node index.js search rust
node index.js search "machine learning"

##API

  • URL Base: https://hacker-news.firebaseio.com/v0/
  • Rate Limit: Nenhum (API pública)
  • Autenticação: Não requerida
Usage Guidance
This skill appears coherent and limited to reading publicly available Hacker News data. If you plan to run it: (1) review or pin the axios dependency (package-lock.json) and install in a controlled environment, (2) run the script locally to confirm behavior, and (3) if you have a policy against allowing skills to make outbound network calls, be aware this performs HTTP requests to the official HN API. Otherwise it does not request credentials or access unrelated resources.
Capability Analysis
Type: OpenClaw Skill Name: hn-reader Version: 1.0.0 The skill is a standard HackerNews CLI tool that interacts with the official HackerNews Firebase API. The code in `src/index.js` implements basic fetching and formatting of stories, user profiles, and search results using the `axios` library. There is no evidence of data exfiltration, malicious execution, or prompt injection; the functionality is entirely consistent with the documentation provided in `SKILL.md`.
Capability Assessment
✓ Purpose & Capability
Name/description match the implementation: the code queries https://hacker-news.firebaseio.com/v0/ and implements top/new/best/ask/show/job/item/user/search commands; required artifacts (axios) are appropriate.
✓ Instruction Scope
SKILL.md describes CLI usage that corresponds to the code. The runtime instructions do not read files, access secrets, or post data to third-party endpoints beyond the official HN API.
✓ Install Mechanism
No install spec; repository is instruction+node script with a single dependency (axios) declared in package.json/package-lock.json — a proportionate dependency for HTTP requests.
✓ Credentials
No environment variables, credentials, or config paths are requested or used. The skill performs only public API requests and does not require secrets.
✓ Persistence & Privilege
Skill is not always-enabled and does not attempt to modify other skills or system-wide settings; autonomous invocation is allowed by platform default but not elevated here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install hn-reader
  3. After installation, invoke the skill by name or use /hn-reader
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Top, New, Best, Ask, Show, Jobs stories, user profiles, and search via HackerNews API
Metadata
Slug hn-reader
Version 1.0.0
License —
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is HN Reader?

Monitors and fetches HackerNews stories via official API, supporting top, new, best, Ask, Show, Jobs categories and keyword searches. It is an AI Agent Skill for Claude Code / OpenClaw, with 404 downloads so far.

How do I install HN Reader?

Run "/install hn-reader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is HN Reader free?

Yes, HN Reader is completely free (open-source). You can download, install and use it at no cost.

Which platforms does HN Reader support?

HN Reader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created HN Reader?

It is built and maintained by runawaydevil (@runawaydevil); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments