Agent skill

Hackernews Intel

by Varnan-Tech in Varnan-Tech/opendirectory

Monitors Hacker News for user-configured keywords, deduplicates against a local SQLite cache, and sends Slack alerts for new matching posts.

MITAuto-check: notesDatabases

Install Hackernews Intel

skills CLI
$ npx skills add Varnan-Tech/opendirectory --skill hackernews-intel -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Varnan-Tech/opendirectory hackernews-intel --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hackernews-intel .claude/skills/hackernews-intel && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hackernews-intel
GitHub stars
674
Used in
1 other repo
Token cost
~1.4k tokens
SKILL.md length
575 words
Files
6 (incl. scripts)
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

Monitors Hacker News for user-configured keywords, deduplicates against a local SQLite cache, and sends Slack alerts for new matching posts.

  • Works in 5 steps: Check Setup → Run the Monitor → Review Results → …
  • Asked to monitor Hacker News for mentions
  • SKILL.md covers Step 1: Check Setup, Step 2: Run the Monitor, Step 3: Review Results and Step 4: Schedule the Monitor, plus 1 more section
  • Runs JavaScript scripts from its folder; calls node, npm and claude; reaches hn.algolia.com

What it does

Hackernews Intel is an agent skill from Varnan-Tech/opendirectory. Monitors Hacker News for user-configured keywords, deduplicates against a local SQLite cache, and sends Slack alerts for new matching posts. Use when asked to monitor Hacker News for mentions, track keywords on HN, get alerts when something is posted about a topic on Hacker News, or set up HN keyword monitoring. Trigger when a user mentions Hacker News alerts, HN monitoring, keyword tracking on HN, or wants to know when a topic appears on Hacker News.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts (for example `README.md`, `evals/evals.json` and `package.json`). Compatibility notes: ["claude-code","gemini-cli","github-copilot"]

It sits in Databases. It works with Slack and SQLite. The repository describes itself as: AI Agent Skills built for Founders who hate Marketing. The licence is MIT.

When your agent uses it

  • Asked to monitor Hacker News for mentions
  • Track keywords on HN
  • Get alerts when something is posted about a topic on Hacker News
  • Set up HN keyword monitoring

Example prompts

  • “Use the hackernews-intel skill to monitor Hacker News for user-configured keywords, deduplicates against a local SQLite cache, and sends Slack…”
  • “/hackernews-intel”

Requirements

  • Node.js
  • Compatibility (from SKILL.md): ["claude-code","gemini-cli","github-copilot"]

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Check Setup
  2. Run the Monitor
  3. Review Results
  4. Schedule the Monitor
  5. Tune Keywords and Thresholds

What it can do on your machine

Read from SKILL.md and the folder at commit 62e437a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • npm
    • claude

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • hn.algolia.com

    Also links to:

    • api.slack.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    ["claude-code","gemini-cli","github-copilot"]

    From compatibility in the SKILL.md frontmatter.

Context cost

Hackernews Intel loads about 1.4k tokens when it runs. Until then it costs about 118 tokens; SKILL.md has 575 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~118
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:142
    Update `HN_KEYWORDS` in your `.env` or environment. No restart needed — the script reads it fresh each run.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Varnan-Tech/opendirectory at commit 62e437a, republished under its MIT licence (© Varnan-Tech). 575 words, ~1,432 tokens.

Download SKILL.mdSave it as .claude/skills/hackernews-intel/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
hackernews-intel
description
Monitors Hacker News for user-configured keywords, deduplicates against a local SQLite cache, and sends Slack alerts for new matching posts. Use when asked to monitor Hacker News for mentions, track keywords on HN, get alerts when something is posted about a topic on Hacker News, or set up HN keyword monitoring. Trigger when a user mentions Hacker News alerts, HN monitoring, keyword tracking on HN, or wants to know when a topic appears on Hacker News.
compatibility
["claude-code","gemini-cli","github-copilot"]
author
OpenDirectory
version
1.0.0

Hacker News Intel

Monitor Hacker News for keywords. On each run, fetch new posts via the HN Algolia API, deduplicate against a local SQLite cache, and send Slack alerts for unseen matches. Run manually or schedule via cron or GitHub Actions.


Step 1: Check Setup

1a. Verify required environment variables

Check that these are set:

  • HN_KEYWORDS (required): comma-separated list of keywords to monitor
  • SLACK_WEBHOOK (required): Slack Incoming Webhook URL for alerts

If either is missing, stop and tell the user:

  • HN_KEYWORDS: list the topics you want to monitor, comma-separated. Example: claude code,LLM agents,deno runtime
  • SLACK_WEBHOOK: create an Incoming Webhook at https://api.slack.com/apps. Select your workspace, enable Incoming Webhooks, and copy the URL.

1b. Verify script dependencies

bash
ls /Users/ksd/Desktop/Varnan_skills/hackernews-intel/node_modules/better-sqlite3 2>/dev/null

If missing:

bash
cd /Users/ksd/Desktop/Varnan_skills/hackernews-intel && npm install

Step 2: Run the Monitor

bash
cd /Users/ksd/Desktop/Varnan_skills/hackernews-intel && node scripts/monitor-hn.js

Flags:

  • --dry-run: print matches to stdout without sending any Slack alerts. Use this to preview what would be alerted before committing.
  • --days=N: on the first run, look back N days (default: 1). Only applies when the SQLite cache is empty.
  • --reset: clear the cache and start fresh. Use when you change your keyword list significantly.

What the script does:

  1. Reads HN_KEYWORDS from environment, splits by comma, trims whitespace
  2. Opens (or creates) a SQLite database at the path in HN_DB_PATH (default: ./hn-intel.db)
  3. For each keyword, calls https://hn.algolia.com/api/v1/search_by_date with numericFilters=created_at_i>lastSeen
  4. For each result, checks if the objectID is already in seen_posts — skips if yes
  5. If HN_MIN_POINTS is set, skips posts below that threshold
  6. For new matching posts, sends a Slack alert and inserts the objectID into the cache
  7. Updates poll_log with the run summary
  8. Prints a summary to stdout

Step 3: Review Results

After the script runs, read its stdout output. It will report:

Run complete.
  Keywords checked: N
  Posts found: N
  Posts alerted: N
  Posts skipped (already seen): N
  Errors: N

If Posts found: 0 and you expect results, check:

  • Are the keywords specific enough? Very broad terms (e.g. "AI") may return 0 results if HN Algolia returns too many and the time window is narrow
  • Is the --days window large enough for the first run? Try --days=7
  • Is the DB cache too aggressive? Try --reset to clear it and rerun

If Posts alerted: 0 but Posts found: N, the deduplication is working — those posts were seen in a previous run.


Show full SKILL.md (213 more words)Show less

Step 4: Schedule the Monitor

Option A: cron (macOS/Linux)

Add to crontab to run every 4 hours:

bash
crontab -e

Add this line (adjust the path to match your install):

0 */4 * * * cd /Users/ksd/Desktop/Varnan_skills/hackernews-intel && node scripts/monitor-hn.js >> /tmp/hn-intel.log 2>&1

Option B: GitHub Actions (recommended for teams)

Create .github/workflows/hn-intel.yml in any repo:

yaml
name: HN Intel Monitor
on:
  schedule:
    - cron: '0 */4 * * *'
  workflow_dispatch:

jobs:
  monitor:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - name: Install dependencies
        run: npm install
        working-directory: hackernews-intel
      - name: Run monitor
        run: node scripts/monitor-hn.js
        working-directory: hackernews-intel
        env:
          HN_KEYWORDS: ${{ secrets.HN_KEYWORDS }}
          SLACK_WEBHOOK: ${{ secrets.SLACK_WEBHOOK }}
          HN_MIN_POINTS: ${{ secrets.HN_MIN_POINTS }}

Add HN_KEYWORDS, SLACK_WEBHOOK, and optionally HN_MIN_POINTS as repository secrets.

Note: GitHub Actions does not persist files between runs, so the SQLite cache resets each run. This means every run will find all posts within the default 1-day lookback window again. For persistent dedup on GitHub Actions, store the DB in a persistent location (S3, artifact cache, or a dedicated branch).


Step 5: Tune Keywords and Thresholds

Adding or changing keywords: Update HN_KEYWORDS in your .env or environment. No restart needed — the script reads it fresh each run.

Setting a minimum points threshold: Set HN_MIN_POINTS=10 to only alert on posts with 10 or more points. This cuts noise for broad keywords.

Including comments (not just stories): Set HN_INCLUDE_COMMENTS=true to also monitor comments mentioning the keyword. Off by default — comments generate significantly more volume.

Resetting the cache: Run node scripts/monitor-hn.js --reset to clear seen_posts and poll_log. The next run fetches fresh from the lookback window.

Testing a new keyword: Run node scripts/monitor-hn.js --dry-run --days=7 to see the last 7 days of matching posts without alerting anyone.

© Varnan-Tech, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts) in skills/hackernews-intel of Varnan-Tech/opendirectory.

  • SKILL.md
  • .env.example
  • README.md
  • evals/evals.json
  • package.json
  • scripts/monitor-hn.js

Open the folder on GitHubat commit 62e437a

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in Varnan-Tech/opendirectory, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Hackernews Intel next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hackernews Intel compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hackernews Intel this skillVarnan-Tech/opendirectory6741 repos~1.4kAutomated safety check: NotesMIT
Pp Slackmvanhorn/printing-press-library2.1k—~9.7kAutomated safety check: NotesApache-2.0
DB Ops SopOpenDCAI/DataMind423—~388Automated safety check: PassApache-2.0
Monstermq Broker Configvogler75/monster-mq143—~2.2kAutomated safety check: PassGPL-3.0
Pp Nasa Imagesmvanhorn/printing-press-library2.1k—~4.1kAutomated safety check: NotesApache-2.0
Apple Notes Core Workflow Bjeremylongshore/tons-of-skills-marketplace2.8k—~1.4kAutomated safety check: PassMIT

Similar skills

  • Pp Slack

    mvanhorn/printing-press-library

    Every Slack read your token can make, mirrored to local SQLite so your history outlives Slack's own retention wall.

    2.1k GitHub stars~9.7k tokensUpdated yesterday
    DatabasesAuto-check: notes
  • DB Ops Sop

    OpenDCAI/DataMind

    Database operations runbook — backup, recovery, performance tuning, troubleshooting.

    423 GitHub stars~388 tokensUpdated 18 days ago
    DatabasesAuto-check passed
  • Monstermq Broker Config

    vogler75/monster-mq

    Guide for configuring, deploying, and operating the MonsterMQ broker.

    143 GitHub stars~2.2k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Pp Nasa Images

    mvanhorn/printing-press-library

    Every NASA Image and Video Library endpoint, plus a local SQLite mirror, FTS search, resumable bulk download,...

    2.1k GitHub stars~4.1k tokensUpdated yesterday
    DatabasesAuto-check: notes
  • Apple Notes Core Workflow B

    jeremylongshore/tons-of-skills-marketplace

    Export and convert Apple Notes to Markdown, JSON, HTML, and SQLite.

    2.8k GitHub stars~1.4k tokensUpdated today
    DatabasesAuto-check passed
  • Patch Release Check

    ClickHouse/ClickHouse

    Check whether ClickHouse's supported versions (last 3 majors + latest LTS) have recent stable patch releases, diagnose why the scheduled AutoReleases pipeline failed, and identify which releases…

    50k GitHub stars~4k tokensUpdated today
    DatabasesAuto-check: notes

More from Varnan-Tech/opendirectory

All 61 skills in this repo
  • Podcast Transcript Fetcher

    Varnan-Tech/opendirectory

    A skill your agent uses when fetching, searching, or analyzing transcripts from Lenny's Podcast, Dwarkesh Podcast, Cheeky Pint, 20VC, or A16z Podcast.

    674 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check: notes
  • Graphic Ebook

    Varnan-Tech/opendirectory

    Creates professionally designed B2B SaaS e-books in HTML + CSS, exported as print-ready PDF.

    674 GitHub stars~5k tokensUpdated 1 mo ago
    Auto-check passed
  • Where Your Customer Lives

    Varnan-Tech/opendirectory

    Given a product utility and ICP, researches the internet to find the specific channels.

    674 GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Docs From Code

    Varnan-Tech/opendirectory

    Generates and updates README.md and API reference docs by reading your codebase's functions, routes, types, schemas, and architecture.

    674 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Graphic Chart

    Varnan-Tech/opendirectory

    Generates data visualization charts (bar, line, area, pie, doughnut, scatter, radar, treemap) as PNG using Apache ECharts v6.

    674 GitHub stars~2.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Graphic Gif

    Varnan-Tech/opendirectory

    Creates animated looping GIFs from CSS animations (default) or AI image-to-video.

    674 GitHub stars~3k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Hackernews Intel

What does Hackernews Intel do?

Monitors Hacker News for user-configured keywords, deduplicates against a local SQLite cache, and sends Slack alerts for new matching posts. Hackernews Intel is an agent skill from Varnan-Tech/opendirectory. Monitors Hacker News for user-configured keywords, deduplicates against a local SQLite cache, and sends Slack alerts for new matching posts.

When should I use Hackernews Intel?

Hackernews Intel fits situations like: asked to monitor Hacker News for mentions; track keywords on HN; get alerts when something is posted about a topic on Hacker News; set up HN keyword monitoring.

How do I install Hackernews Intel in Claude Code?

Run `npx skills add Varnan-Tech/opendirectory --skill hackernews-intel -a claude-code`. Or copy the skill folder (skills/hackernews-intel in Varnan-Tech/opendirectory) into .claude/skills/hackernews-intel in your project. Claude Code loads it when a task matches its description.

How do I install Hackernews Intel in Codex?

Run `npx skills add Varnan-Tech/opendirectory --skill hackernews-intel -a codex`. Or copy the skill folder (skills/hackernews-intel in Varnan-Tech/opendirectory) into .agents/skills/hackernews-intel in your project. Codex loads it when a task matches its description.

Can I use Hackernews Intel in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Varnan-Tech/opendirectory --skill hackernews-intel -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hackernews-intel, .gemini/skills/hackernews-intel, .github/skills/hackernews-intel and .opencode/skills/hackernews-intel in your project.

What does Hackernews Intel need to run?

Going by SKILL.md and its folder, Hackernews Intel needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node, npm and claude). Our summary lists: Node.js. Compatibility (from SKILL.md): ["claude-code","gemini-cli","github-copilot"].

Does Hackernews Intel access the network?

SKILL.md names 2 domains. In commands or code: hn.algolia.com; the agent is likely to contact it when it follows the instructions. As links in the text: api.slack.com. This is read from the text; nothing was executed.

Is Hackernews Intel safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Hackernews Intel use?

Hackernews Intel is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hackernews Intel use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Hackernews Intel?

Skills that share tags, products or a category with Hackernews Intel: Pp Slack (mvanhorn/printing-press-library, 2.1k stars), DB Ops Sop (OpenDCAI/DataMind, 423 stars), Monstermq Broker Config (vogler75/monster-mq, 143 stars) and Pp Nasa Images (mvanhorn/printing-press-library, 2.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hackernews Intel?

Varnan-Tech (a GitHub organization) maintains it in Varnan-Tech/opendirectory, which has 674 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on August 16, 2026.

Source: Varnan-Tech/opendirectory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.