Agent skill

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.

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/hexbee/hello-skills/tree/main/skills/hn-top10

SKILL.md

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:

bash
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:

text
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.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

hexbee/hello-skills

analogy-commentary

Turn source content into a familiar analogy framework, then produce concise commentary angles and a short take. Use when the user asks whether a post, article, speech, or idea is “like” a known story, theory, faction, historical pattern, or strategic lens.

0 0
Explore
hexbee/hello-skills

deep-productivity

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.

0 0
Explore
hexbee/hello-skills

multi-agent-systems

Design and implement multi-agent LLM architectures using the orchestrator-subagent pattern. Use when: (1) Deciding whether to use multi-agent vs single-agent systems, (2) Implementing context isolation for high-volume operations, (3) Parallelizing independent research tasks, (4) Creating specialized agents with focused tool sets, (5) Building verification subagents for quality assurance, or (6) Analyzing context-centric decomposition boundaries.

0 0
Explore
hexbee/hello-skills

agent-first-product-strategy

Reframe AI product and SaaS strategy from human-user assumptions to agent-first execution. Use when redefining product positioning, success metrics, API/docs priorities, go-to-market, or roadmap decisions for an AI-native market where agents are primary software users.

0 0
Explore
hexbee/hello-skills

claim-ledger

将研究与写作中的主张转成“Claim-Evidence-Boundary”可核验账本。用于在产出前强制补齐证据、反证、边界与可发布性判断，防止无依据断言并提升复用性。

0 0
Explore
hexbee/hello-skills

debog-yourself

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.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results