# Show HN: Buildnotes – Turn pull requests in "how it's made" posts

> Source: <https://buildnotes.releases.sh/>
> Published: 2026-10-22 18:27:28+00:00

# Turn pull requests into posts and videos worth sharing. How it was built, and why.

A skill for coding agents. It reads a feature's issues, PRs and reviews, and finds the few decisions that shaped it.

`npx skills add buildinternet/buildnotes`

For Claude Code, Codex and OpenCode

Then, inside your repo:`/buildnotes` **[post | video | deck]** *what to explain*

 
/buildnotesbefore and after screenshots, side by sideHow we built room walkthrough videos

 
 
Example

## Walkthrough videos in Sunny

 
`/buildnotes How we built room walkthrough videos`

 
## How it works

### Gather

Reads the issues, PRs, commits and reviews.

### Plan

Picks the few decisions worth a chapter.

### Write and check

Draws the figures, writes it up, and checks it.

 
## What it makes

Ask in plain words, inside the repo. The first word picks the output; the post is the default. Ask for a technical deep dive or a release story to write for engineers or for users.

### Post

Chapters, drawn figures and real code, as a page you can publish as is or move to your own site.

`/buildnotes post how we built preview links`

 
### Video

The post as a short video that plays itself.

`/buildnotes video tech explainer of our latest PR`

 
### Deck

The video as slides you click through, and a PDF.

`/buildnotes deck slides on the new billing flow`

 
### Figures

Any figure on its own, as an image, GIF, video or SVG.

 
 
## What it draws

Figures come from the real product. This one started as a screenshot of the weekly digest card in Release Notes Index, redrawn straight on so each part can be named.

## More examples

Before and after screenshots: tag two, and the pull request comment shows them side by side.

Weekly digests: a card, a replay of the week, and one email a week per reader.

 
## Install

Needs Node 22, git and Chrome.

`npx skills add buildinternet/buildnotes`

Then, inside your repo:

`/buildnotes write up how we built preview links, from PRs 120, 131 and 140`
