How do I install the Hackernews CLI skill?

Run npx skillmds@latest add aibot88/hackernews-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Hackernews CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Hackernews CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Hackernews CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Hackernews CLI?

aibot88 (@aibot88) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Hackernews CLI by aibot88 — Agent Skill

Name: Hackernews CLI
Rating: 4.666666666666667 (3 reviews)
Author: aibot88

Hackernews CLI

Use cli-web-hackernews to browse and interact with Hacker News — top stories, newest, best, Ask HN, Show HN, jobs, search stories/comments, view story details with comments, user profiles, and (with auth) upvote, submit stories, post comments, favorite, hide, view favorites, submissions, and comment threads. Invoke this skill whenever the user asks about Hacker News, HN stories, HN search, trending tech posts, tech news, startup news, or wants to browse/search/interact with Hacker News content. Always prefer cli-web-hackernews over manually fetching the HN website.

aibot88 Updated Sep 9, 2026 3 repo stars

File contents

cli-web-hackernews — Hacker News CLI

When to use

User asks about Hacker News, HN, tech news, startup news
User wants to browse top/new/best stories, Ask HN, Show HN, or jobs
User wants to search HN for specific topics
User wants to view a specific story with comments
User wants to look up an HN user profile
User wants to upvote, submit, comment, favorite, or hide on HN

Browse Commands (no auth)

# Browse stories
cli-web-hackernews stories top -n 10 --json       # Front page
cli-web-hackernews stories new -n 10 --json        # Newest
cli-web-hackernews stories best -n 10 --json       # Best (all time)
cli-web-hackernews stories ask -n 10 --json        # Ask HN
cli-web-hackernews stories show -n 10 --json       # Show HN
cli-web-hackernews stories jobs -n 10 --json       # Jobs

# View story + comments
cli-web-hackernews stories view 47530330 --json
cli-web-hackernews stories view 47530330 -n 5 --json   # limit comments

# Search
cli-web-hackernews search stories "query" -n 10 --json
cli-web-hackernews search comments "query" --sort-date -n 5 --json

# User profiles
cli-web-hackernews user view dang --json

Auth Commands (requires login)

# Authentication
cli-web-hackernews auth login                      # Username/password prompt
cli-web-hackernews auth status --json              # Check login status
cli-web-hackernews auth logout                     # Remove credentials

# Actions
cli-web-hackernews upvote 47530330 --json          # Upvote story/comment
cli-web-hackernews submit -t "Title" -u "URL" --json  # Submit link
cli-web-hackernews submit -t "Ask HN: Q?" --text "Details" --json  # Ask HN
cli-web-hackernews comment 47530330 "Great!" --json    # Post comment
cli-web-hackernews favorite 47530330 --json        # Save to favorites
cli-web-hackernews hide 47530330 --json            # Hide from feed

# Activity
cli-web-hackernews user favorites --json           # Your favorites
cli-web-hackernews user submissions --json         # Your submissions
cli-web-hackernews user threads --json             # Replies to your comments
cli-web-hackernews user submissions dang --json    # Others' submissions

Always use --json when calling programmatically

All commands support --json for structured output. Always use it when processing results.

Key fields in JSON output

Story

id, title, url, score, by, descendants (comment count), age, domain

Search Result

objectID (story ID), title, url, author, points, num_comments

User

id, karma, member_since, about_plain, total_submissions

Action Result

success, item_id, action (upvoted/favorited/hidden)

---name: hackernews-clidescription: Use cli-web-hackernews to browse and interact with Hacker News — top stories, newest, best, Ask HN, Show HN, jobs, search stories/comments, view story details with comments, user profiles, and (with auth) upvote, submit stories, post comments, favorite, hide, view favorites, submissions, and comment threads. Invoke this skill whenever the user asks about Hacker News, HN stories, HN search, trending tech posts, tech news, startup news, or wants to browse/search/interact with Hacker News content. Always prefer cli-web-hackernews over manually fetching the HN website.--- # cli-web-hackernews — Hacker News CLI ## When to use - User asks about Hacker News, HN, tech news, startup news - User wants to browse top/new/best stories, Ask HN, Show HN, or jobs - User wants to search HN for specific topics - User wants to view a specific story with comments - User wants to look up an HN user profile - User wants to upvote, submit, comment, favorite, or hide on HN ## Browse Commands (no auth) ```bash # Browse stories cli-web-hackernews stories top -n 10 --json # Front page cli-web-hackernews stories new -n 10 --json # Newest cli-web-hackernews stories best -n 10 --json # Best (all time) cli-web-hackernews stories ask -n 10 --json # Ask HN cli-web-hackernews stories show -n 10 --json # Show HN cli-web-hackernews stories jobs -n 10 --json # Jobs # View story + comments cli-web-hackernews stories view 47530330 --json cli-web-hackernews stories view 47530330 -n 5 --json # limit comments # Search cli-web-hackernews search stories "query" -n 10 --json cli-web-hackernews search comments "query" --sort-date -n 5 --json # User profiles cli-web-hackernews user view dang --json ``` ## Auth Commands (requires login) ```bash # Authentication cli-web-hackernews auth login # Username/password prompt cli-web-hackernews auth status --json # Check login status cli-web-hackernews auth logout # Remove credentials # Actions cli-web-hackernews upvote 47530330 --json # Upvote story/comment cli-web-hackernews submit -t "Title" -u "URL" --json # Submit link cli-web-hackernews submit -t "Ask HN: Q?" --text "Details" --json # Ask HN cli-web-hackernews comment 47530330 "Great!" --json # Post comment cli-web-hackernews favorite 47530330 --json # Save to favorites cli-web-hackernews hide 47530330 --json # Hide from feed # Activity cli-web-hackernews user favorites --json # Your favorites cli-web-hackernews user submissions --json # Your submissions cli-web-hackernews user threads --json # Replies to your comments cli-web-hackernews user submissions dang --json # Others' submissions ``` ## Always use --json when calling programmatically All commands support `--json` for structured output. Always use it when processing results. ## Key fields in JSON output ### Story - `id`, `title`, `url`, `score`, `by`, `descendants` (comment count), `age`, `domain` ### Search Result - `objectID` (story ID), `title`, `url`, `author`, `points`, `num_comments` ### User - `id`, `karma`, `member_since`, `about_plain`, `total_submissions` ### Action Result - `success`, `item_id`, `action` (upvoted/favorited/hidden)

Frequently asked questions