# Hn Extract

> Extract a HackerNews post (article + comments) into single clean Markdown for quick reading or LLM input.

- Skill: `guoqiao/hn-extract` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add guoqiao/hn-extract`
- Raw SKILL.md: https://api.skillmd.com/api/skills/guoqiao/hn-extract/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: guoqiao (https://skillmd.com/u/guoqiao)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/guoqiao/hn-extract

---


# HackerNews Extract

Extract a HackerNews post (article + comments) into single clean Markdown for quick reading or LLM input.

see [Examples](https://github.com/guoqiao/skills/blob/main/hn-extract/examples)

Use this skill when the user types `/hn-extract` or asks to extract/summarize a HackerNews Post.

**Triggers:**
- "Extract HN Post ..."
- "/hn-extract <hn_id_or_url>"
- "Summarize this HN post ..."

## What it does
- Accepts an HackerNews id or url
- Download the linked article HTML, extracts text, cleans and formats it.
- Fetches the Hacknews post metadata and comments.
- Outputs a readable combined markdown file with original article, threaded comments, and key metadata.

## Requirements

- `uv` installed and in PATH.

## Install

No install beyond having `uv`.
Dependencies will be installed automatically by `uv` into to a dedicated venv when run this script.

## Usage Workflow (Mandatory for Agents)

When an agent is asked to extract a HackerNews post:
1.  **Run the script** with an output path: `uv run --script ${baseDir}/hn_extract.py <input> -o /tmp/hn-<id>.md`.
2.  **Send ONE combined message:** Upload the file and ask the question in the *same* tool call. Use the `message` tool (`action=send`, `filePath="/tmp/hn-<id>.md"`, `message="Extraction complete. Do you want me to summarize it?"`).
3.  **Do not** output the full text or a summary directly in the chat unless specifically requested.

## Usage

```bash
# run as uv script
uv run --script ${baseDir}/hn_extract.py <hn-id|hn-url> [-o path/to/output.md]

# Examples
uv run --script ${baseDir}/hn_extract.py 46861313 -o /tmp/output.md
uv run --script ${baseDir}/hn_extract.py "https://news.ycombinator.com/item?id=46861313"
```

- Omit `-o` to print to stdout.
- Directories for `-o` are created automatically.

## Notes
- Retries are enabled for HTTP fetches.
- Comments are indented by thread depth.
- Sites requires authentication or blocks scraping may still fail.