hn-digest
SKILL.md
HN Digest
Command format
Interpret a user message that starts with hn as a request for a Hacker News front-page digest.
Supported forms:
hn→ default 5 postshn <n>→ n postshn <topic>→ filter/boost by topichn <n> <topic>→ both- If the user asks for “more” after already seeing some (e.g. “show me top 10–15 since we already did top 10”), treat it as an offset request and use
--offset(e.g. offset 10, count 10).
Topics:
tech(default)healthhackinglife/lifehacks
Output requirements
- Do not send any extra commentary/preamble/epilogue.
- Send results as individual messages.
- Each post message must be exactly:
- first line: the post title
- second line:
<age> · <commentCount> comments(age like45m ago,6h ago,3d ago) - third line: the Hacker News comments link (
https://news.ycombinator.com/item?id=...)
- After the post messages, send one final message that is the generated image.
- If the chat provider requires non-empty text for media, use a minimal caption
..
- If the chat provider requires non-empty text for media, use a minimal caption
- Hard exclude crypto.
Procedure
- Parse
nandtopicfrom the user message. - Fetch + rank items:
- Run
node skills/hn-digest/scripts/hn.mjs --count <n> --offset <offset> --topic <topic> --format json. - Default
offsetis 0 unless the user explicitly asks for “more/next” after a previous batch.
- Run
- Send results as N individual messages in the required 3-line format.
- Then generate a delightful mood image via Nano Banana, inspired by the posts you just sent:
- Use
skills/hn-digest/scripts/mood_prompt.mjsto build a prompt from the JSON items. - Add 3–4 subtle Easter eggs derived from the post themes (no text/logos; keep it fun).
- Generate and attach the image by running:
skills/hn-digest/scripts/generate_mood_nano_banana.sh ./tmp/hn-mood/hn-mood.png <topic> <n> <offset>
- Send the generated image as one additional message.
- Use
If fetching/ranking fails or returns 0 items:
- Use
https://news.ycombinator.com/in the browser tool, pick N non-crypto items by judgment, and send them in the same 3-line format. - Still generate a mood image (general “HN tech deep dives” vibe) with a banana Easter egg.
Weekly Installs
4
Repository
clawdbot/skillsInstalled on
opencode3
windsurf2
clawdbot2
trae2
codex2
claude-code2