hn

Name: hn
Author: mahsumaktas

Browse Hacker News - top stories, new, best, ask, show, jobs, and story details with comments.

by mahsumaktas(0) 0 installs

Free

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from mahsumaktas/agent-evolution-kit (skills/hn/SKILL.md). Install upstream with npx skills add mahsumaktas/agent-evolution-kit --skill hn. Copyright stays with the author.

Hacker News

Read Hacker News from the command line.

Commands

Other Feeds

uv run {baseDir}/scripts/hn.py new          # Newest stories
uv run {baseDir}/scripts/hn.py best         # Best stories
uv run {baseDir}/scripts/hn.py ask          # Ask HN
uv run {baseDir}/scripts/hn.py show         # Show HN
uv run {baseDir}/scripts/hn.py jobs         # Jobs

Story Details

uv run {baseDir}/scripts/hn.py story <id>              # Story with top comments
uv run {baseDir}/scripts/hn.py story <id> --comments 20 # More comments

Search

uv run {baseDir}/scripts/hn.py search "AI agents"      # Search stories
uv run {baseDir}/scripts/hn.py search "Claude" -n 5    # Limit results

API

Uses the official Hacker News API (no auth required).

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot
curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

mahsumaktas-agent-evolution-kit-hn.ocm.jsonjson

{
  "ocm": "1",
  "id": "mahsumaktas-agent-evolution-kit-hn",
  "kind": "skill",
  "name": "hn",
  "description": "Browse Hacker News - top stories, new, best, ask, show, jobs, and story details with comments.",
  "publisher": "mahsumaktas",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "creative"
    ],
    "tags": [
      "skill-md",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Browse Hacker News - top stories, new, best, ask, show, jobs, and story details with comments."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/mahsumaktas/agent-evolution-kit",
      "path": "skills/hn/SKILL.md",
      "ref": "c599c874b0625f7a3dc3d1676a07fd377720f52e",
      "url": "https://github.com/mahsumaktas/agent-evolution-kit/blob/c599c874b0625f7a3dc3d1676a07fd377720f52e/skills/hn/SKILL.md",
      "key": "mahsumaktas/agent-evolution-kit/skills/hn/SKILL.md"
    }
  },
  "instructions": "# Hacker News\n\nRead Hacker News from the command line.\n\n## Commands\n\n### Top Stories\n```bash\nuv run {baseDir}/scripts/hn.py top          # Top 10 stories\nuv run {baseDir}/scripts/hn.py top -n 20    # Top 20 stories\n```\n\n### Other Feeds\n```bash\nuv run {baseDir}/scripts/hn.py new          # Newest stories\nuv run {baseDir}/scripts/hn.py best         # Best stories\nuv run {baseDir}/scripts/hn.py ask          # Ask HN\nuv run {baseDir}/scripts/hn.py show         # Show HN\nuv run {baseDir}/scripts/hn.py jobs         # Jobs\n```\n\n### Story Details\n```bash\nuv run {baseDir}/scripts/hn.py story <id>      ",
  "cost": {
    "context_tokens": 244
  }
}

Fetch it by URL: GET /api/v1/registry/mahsumaktas-agent-evolution-kit-hn/manifest?version=1.0.0