hexbee/hn-top10
skills/hn-top10/SKILL.md
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.
development
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add hexbee/hello-skills hn-top10Install this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 8:04 AM9.4s2 files scanned
SKILL.md
- name:
- hn-top10
- description:
- 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.
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: default10; allow1-30format: defaultjsonoutput_path: default a timestamped JSON file using local time, such ashn-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:
- A saved machine-readable file.
- 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.
Related Skills
hexbee/fix-orbstack-docker-pull
testing
VerifiedTrustedCommunity
Diagnose and fix Docker image pull failures on macOS with OrbStack, especially Docker Hub EOF/TLS/manifest errors caused by system proxies, Clash/CyberClash/Mihomo/Surge-style TUN mode, fake-ip DNS such as 198.18.0.x, or unstable registry access. Use when `docker pull` or `docker manifest inspect` fails with EOF, SSL_ERROR_SYSCALL, failed to fetch anonymous token, failed to resolve reference, failed to copy, or registry-1.docker.io/auth.docker.io connectivity confusion.
SKILL.mdUpdated Apr 24, 2026
hexbee/resume-builder
development
VerifiedTrustedCommunity
Generate and revise job resumes from raw notes, existing resumes, career histories, or profile snippets. Use when Codex needs to create, redesign, tighten, or review a resume/CV, especially for Chinese or English A4 resumes, PDF/HTML output, first-screen hiring signal, skill ordering, pagination balance, header/contact layout, or reframing an engineering background for AI-focused roles.
SKILL.mdUpdated Apr 22, 2026
hexbee/url-to-markdown
development
VerifiedTrustedCommunity
Convert a public webpage URL into Markdown and save it as a reusable `.md` file with the bundled script. Prefer `https://r.jina.ai/<url>` first, and only fallback to `https://markdown.new/` if `r.jina.ai` is unavailable. Use this whenever the user wants to turn a public webpage, article, documentation page, blog post, release note, or reference URL into Markdown for reading, archiving, summarizing, extraction, RAG prep, or downstream agent reuse, even if they do not explicitly mention markdown or saving a file.
SKILL.mdUpdated Apr 16, 2026
hexbee/saas-agent-toolkit
tools
VerifiedTrustedCommunity
Design agent-usable SaaS tool systems using six reusable tool shapes (Search, Summarize, Draft, Update, Notify, Approve) plus connectors and policy guardrails. Use when turning SaaS features into reliable agent actions with clear contracts, permissions, audit trails, and approval gates.
SKILL.mdUpdated Apr 16, 2026