MCPInstall

hn-top10

Fetch the current top Hacker News stories and return agent-friendly structured results. Use this whenever the user explicitly asks about Hacker News or HN, and also when they ask for today's developer, startup, YC, or tech-community hot stories where Hacker News is a strong default source.

Installs
84
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/hexbee/hello-skills --skill hn-top10
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads hn-top10 automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

HN Top 10

Overview

Use this skill to pull the latest Hacker News front-page stories, save the full result as JSON, and return a concise summary the agent can keep using in the conversation.

When To Use

Use this skill when the user asks for:

  • Hacker News top stories
  • HN front-page posts
  • top 10 HN items
  • current developer hot topics
  • today's startup or YC community stories
  • a quick scan of tech-community discussion

If the user asks for broad industry news that clearly requires multiple sources, do not rely on this skill alone. Use it as one input, not the full answer.

Inputs

Decide these inputs before running the script:

  • limit: default 10; allow 1-30
  • format: default json
  • output_path: default a timestamped JSON file using local time, such as hn-top10-20260302-231500.json

If the user does not specify a count, keep the default 10.

Run The Script

Run:

python skills/hn-top10/scripts/hn_top10.py --json --limit 10 --output <output_path>

Adjust --limit and --output when the user asks for something different. When saving JSON, the script will ensure the filename includes a timestamp. If --output is omitted, it creates a timestamped JSON file automatically.

If the user explicitly wants CSV, run without --json.

Required Output Behavior

Always produce both:

  1. A saved machine-readable file.
  2. A short conversational summary.

The summary should include:

  • what source was used: Hacker News front page
  • how many items were fetched
  • the top 3-5 story titles
  • notable patterns if obvious: repeated topics, AI concentration, startup themes, security incidents
  • the saved file path

Summary Template

Use this structure:

Source: Hacker News front page
Items fetched: <N>
Top stories:
1. <title>
2. <title>
3. <title>

Patterns:
- <pattern or "No strong pattern">

Saved JSON:
<path>

Error Handling

If the script fails:

  • say that Hacker News fetch or parsing failed
  • include the command error briefly
  • do not invent stories or partial results
  • ask whether to retry or use another source

If the user asked for general tech hot topics and this skill fails, explicitly note that the HN signal is unavailable and another source set is needed.

Notes

  • Prefer JSON because agents can reuse it in later steps.
  • Treat the JSON file as the source of truth for downstream processing.
  • Do not claim these are all tech-news trends; they are Hacker News front-page signals.

FAQ

What does the hn-top10 skill do?

Fetch the current top Hacker News stories and return agent-friendly structured results. Use this whenever the user explicitly asks about Hacker News or HN, and also when they ask for today's developer, startup, YC, or tech-community hot stories where Hacker News is a strong default source.

How do I install hn-top10?

Run npx skills add https://github.com/hexbee/hello-skills --skill hn-top10 in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/hn-top10/ (personal) or .claude/skills/hn-top10/ (project).

Which AI agents can use hn-top10?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is hn-top10 safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains hn-top10?

It is published by hexbee in hexbee/hello-skills. It has 84 recorded installs.

More from hexbee/hello-skills

View all →

deep-productivity

hexbee/hello-skills

Master deep work productivity through the three types of work framework (Building, Maintenance, Recovery). Use when user needs to: (1) Build a sustainable deep work routine with just 1 hour/day, (2) Create vision/anti-vision for life direction, (3) Structure goals using the 10-year → 1-year → 1-month → 1-week hierarchy, (4) Apply project-based learning to bridge skill gaps, (5) Identify lever-moving tasks that actually progress goals, (6) Balance focus work with necessary recovery for creativity.

mungers-lattice

hexbee/hello-skills

Multidisciplinary analytical engine using Charlie Munger's latticework of mental models. Applies cross-disciplinary thinking (math, physics, biology, psychology, economics) to dissect life and business decisions. Use when user presents a decision problem, investment question, or complex analysis request requiring deep rational analysis.

Open the skill to read its SKILL.md instructions.

90 installs

learning-first-principles

hexbee/hello-skills

A cognitive framework based on learning first principles, providing learning method diagnosis, efficiency assessment, and optimization advice. Use when: (1) Diagnosing if current learning methods align with first principles, (2) Evaluating learning plan efficiency and time investment, (3) Analyzing learning behavior problems and providing improvement suggestions, (4) Determining if learning content is worth the time investment. Core principle chain: Self-learning → Induction → Self-output → Expression restructuring → Logical understanding → Practice.

instreet-operator

hexbee/hello-skills

Deprecated: this skill has been deprecated. Use this when working with InStreet forum or Playground flows. It restores account state from /.instreet, can auto-register when no local account exists, and routes all InStreet API requests through the bundled Python client. It has first-class commands for forum, groups, literary, arena, oracle, and games workflows, with raw api fallback for long-tail endpoints.

Backend & APIs72 installs

debog-yourself

hexbee/hello-skills

Help users identify and escape psychological traps that are holding them back. Use when user feels stuck, unable to progress, facing a deadlock, or experiencing decision paralysis. Provide diagnostic frameworks and specific strategies to help users understand which trap pattern they're in and find a path forward.

51 installs

Popular business & finance skills

View category →

sales-enablement

coreyhaines31/marketingskills

When the user wants to create sales collateral, pitch decks, one-pagers, objection handling docs, or demo scripts. Also use when the user mentions 'sales deck,' 'pitch deck,' 'one-pager,' 'leave-behind,' 'objection handling,' 'deal-specific ROI analysis,' 'demo script,' 'talk track,' 'sales playbook,' 'proposal template,' 'buyer persona card,' 'battle card,' 'battlecard,' 'competitive one-pager,' 'win-loss analysis,' 'why are we losing deals,' 'loss reasons,' 'how do I respond to this objection,' 'prospect just said,' 'help my sales team,' 'sales materials,' or 'what should I give my sales reps,' 'cold call script,' or 'voicemail script.' Use this for any document or asset that helps a sales team close deals. For public competitor comparison pages, see competitors. For running buyer interviews or churn research, see customer-research. For marketing website copy, see copywriting. For cold outreach emails, see cold-email. For the offer being sold (bonuses, guarantees, pricing structure),

Business & Finance119.5K installs

revops

coreyhaines31/marketingskills

When the user wants help with revenue operations, lead lifecycle management, or marketing-to-sales handoff processes. Also use when the user mentions 'RevOps,' 'revenue operations,' 'lead scoring,' 'outbound pipeline stages,' 'lead routing,' 'MQL,' 'SQL,' 'pipeline stages,' 'deal desk,' 'CRM automation,' 'marketing-to-sales handoff,' 'data hygiene,' 'leads aren't getting to sales,' 'pipeline management,' 'lead qualification,' or 'when should marketing hand off to sales.' Use this for anything involving the systems and processes that connect marketing to revenue. For cold outreach emails, see cold-email. For email drip campaigns, see emails. For pricing decisions, see pricing.

Business & Finance114.1K installs

sales-funnel-blueprint

autonnel/autonnel-skills

Turn an offer into a concrete multi-step sales funnel spec - page-by-page structure, price ladder, copy outline and the metrics each step must hit. Use when asked to build a sales funnel, marketing funnel, landing page flow, lead magnet funnel, webinar funnel, tripwire or VSL funnel, when planning a product launch page flow, or when someone asks "what pages do I need" for selling something online.

Business & Finance104.5K installs

pricing

coreyhaines31/marketingskills

When the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increase,' 'value metric,' 'Van Westendorp,' 'willingness to pay,' 'monetization,' 'how much should I charge,' 'my pricing is wrong,' 'pricing page,' 'annual vs monthly,' 'per seat pricing,' 'should I offer a free plan,' 'pricing page teardown,' 'pricing page audit,' 'is my pricing page AI-readable,' or 'can AI read my pricing.' Use this whenever someone is figuring out what to charge, how to structure their plans, or wants to audit a pricing page (for humans and for the AI agents that shortlist tools). For in-app upgrade screens, see paywalls. For offer construction (bonuses, guarantees, value framing, naming) on services/courses/coaching/high-ticket B2B, see offers.

Business & Finance80K installs

cross-border-ecommerce

nexscope-ai/ecommerce-skills

Cross-border e-commerce expansion advisor. Scores target markets on 8 weighted dimensions (market size, ecommerce penetration, competition, regulatory complexity, logistics infrastructure, payment ecosystem, cultural distance, IP protection), compares 5 fulfillment models with cost and transit data, provides country-by-country tax/duty compliance guides (EU VAT/IOSS, UK VAT, US sales tax, CA GST, AU GST, JP consumption tax), maps local payment preferences by market, and builds a phased expansion roadmap. No API key required.

Business & Finance62.9K installs

pricing-strategy

coreyhaines31/marketingskills

When the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increase,' 'value metric,' 'Van Westendorp,' 'willingness to pay,' 'monetization,' 'how much should I charge,' 'my pricing is wrong,' 'pricing page,' 'annual vs monthly,' 'per seat pricing,' or 'should I offer a free plan.' Use this whenever someone is figuring out what to charge or how to structure their plans. For in-app upgrade screens, see paywall-upgrade-cro.

Business & Finance61.2K installs