{"slug": "show-hn-buildnotes-turn-pull-requests-in-how-it-s-made-posts", "title": "Show HN: Buildnotes – Turn pull requests in \"how it's made\" posts", "summary": "Buildinternet released Buildnotes, a skill for coding agents that reads a feature's issues, pull requests, commits and reviews and turns them into \"how it's made\" posts, videos, decks and standalone figures. Buildnotes installs via `npx skills add buildinternet/buildnotes` and runs inside a repository with the `/buildnotes [post | video | deck]` command on Claude Code, Codex and OpenCode, requiring Node 22, git and Chrome. The tool works in three steps — gathering the issues, PRs, commits and reviews, picking the few decisions worth a chapter, then drawing figures, writing the piece and checking it — and can target output at engineers or users.", "body_md": "# Turn pull requests into posts and videos worth sharing. How it was built, and why.\n\nA skill for coding agents. It reads a feature's issues, PRs and reviews, and finds the few decisions that shaped it.\n\n`npx skills add buildinternet/buildnotes`\n\nFor Claude Code, Codex and OpenCode\n\nThen, inside your repo:`/buildnotes` **[post | video | deck]** *what to explain*\n\n \n/buildnotesbefore and after screenshots, side by sideHow we built room walkthrough videos\n\n \n \nExample\n\n## Walkthrough videos in Sunny\n\n \n`/buildnotes How we built room walkthrough videos`\n\n \n## How it works\n\n### Gather\n\nReads the issues, PRs, commits and reviews.\n\n### Plan\n\nPicks the few decisions worth a chapter.\n\n### Write and check\n\nDraws the figures, writes it up, and checks it.\n\n \n## What it makes\n\nAsk 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.\n\n### Post\n\nChapters, drawn figures and real code, as a page you can publish as is or move to your own site.\n\n`/buildnotes post how we built preview links`\n\n \n### Video\n\nThe post as a short video that plays itself.\n\n`/buildnotes video tech explainer of our latest PR`\n\n \n### Deck\n\nThe video as slides you click through, and a PDF.\n\n`/buildnotes deck slides on the new billing flow`\n\n \n### Figures\n\nAny figure on its own, as an image, GIF, video or SVG.\n\n \n \n## What it draws\n\nFigures 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.\n\n## More examples\n\nBefore and after screenshots: tag two, and the pull request comment shows them side by side.\n\nWeekly digests: a card, a replay of the week, and one email a week per reader.\n\n \n## Install\n\nNeeds Node 22, git and Chrome.\n\n`npx skills add buildinternet/buildnotes`\n\nThen, inside your repo:\n\n`/buildnotes write up how we built preview links, from PRs 120, 131 and 140`", "url": "https://wpnews.pro/news/show-hn-buildnotes-turn-pull-requests-in-how-it-s-made-posts", "canonical_source": "https://buildnotes.releases.sh/", "published_at": "2026-10-22 18:27:28+00:00", "updated_at": "2026-10-22 18:42:23.709333+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "generative-ai"], "entities": ["Buildinternet", "Buildnotes", "Claude Code", "Codex", "OpenCode", "Sunny", "Node 22", "Chrome"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/show-hn-buildnotes-turn-pull-requests-in-how-it-s-made-posts", "markdown": "https://wpnews.pro/news/show-hn-buildnotes-turn-pull-requests-in-how-it-s-made-posts.md", "text": "https://wpnews.pro/news/show-hn-buildnotes-turn-pull-requests-in-how-it-s-made-posts.txt", "jsonld": "https://wpnews.pro/news/show-hn-buildnotes-turn-pull-requests-in-how-it-s-made-posts.jsonld"}}