Release
Deck No. 10 · Project
Open-Source Release
From a private repository to a public one people can build, trust and join.
The first public release of a library or tool that lived in a private repository: history checked for secrets, licence and docs in place, a README that shows the thing working, and a tagged release with notes.
npx skills add trailofbits/skills@149d7b21f4067765b82e67029730b42d228ef4b4 --skill open-sourcing -g -y && \ npx skills add getsentry/skills@a582c51ee29d0f35e6ac321340796f77d43da733 --skill find-bugs agents-md -g -y && \ npx skills add tt-a1i/archify@8509a3d63e763b4d454ea9aafa1f939545fcb1ea --skill archify -g -y && \ npx skills add vercel-labs/webreel@1504682685514107e48a1696490666eb9ed7da14 --skill webreel -g -y && \ npx skills add mitsuhiko/agent-stuff@0865c849befd2021490679f96a8dee58c84ac857 --skill update-changelog -g -y
npx skills add trailofbits/skills@149d7b21f4067765b82e67029730b42d228ef4b4 --skill open-sourcing -g -y npx skills add getsentry/skills@a582c51ee29d0f35e6ac321340796f77d43da733 --skill find-bugs agents-md -g -y npx skills add tt-a1i/archify@8509a3d63e763b4d454ea9aafa1f939545fcb1ea --skill archify -g -y npx skills add vercel-labs/webreel@1504682685514107e48a1696490666eb9ed7da14 --skill webreel -g -y npx skills add mitsuhiko/agent-stuff@0865c849befd2021490679f96a8dee58c84ac857 --skill update-changelog -g -y
Fetches 6 skills from 5 author repos, each pinned to the version we reviewed. Nothing is mirrored. Uses the open-source skills CLI; needs Node.js 22.20 or newer.
Opens Claude Code with the install prompt already typed. Nothing runs until you press Enter.
Skills installed from a terminal do not reach claude.ai. A one-step route for claude.ai is in the works.
Until then you can add skills one at a time: open a card below, follow the link to the author's repo, and upload that skill folder as a ZIP under Customize, then Skills.
What's inside
6 skills. Each card links to its author's repository at the exact version we reviewed.
- Open-sourcing a repository 1/6 Release readiness Needs app Takes a private repository to a public release in order: a secrets audit of the full history first, then licence, README, SECURITY.md, CI hardening, branch protection and releases. @trailofbits CC BY-SA 4.0 Source trailofbits/skills at 149d7b2
Open-sourcing a repository
The checklist in the right order. Secrets in the git history come first, because that is the one mistake you cannot fix after publication, then licence, docs, CI and releases.
- Find bugs 2/6 Code review Needs account Reviews every changed line on your branch for bugs and security holes against a fixed checklist, verifies each suspicion, then reports findings without editing code. @getsentry Apache-2.0 Source getsentry/skills at a582c51
Find bugs
A last review of the release branch before strangers read it. Every changed line is checked for bugs and security holes, and findings are reported without edits.
- AGENTS.md maintainer 3/6 Agent instructions Ready Writes and trims AGENTS.md so it stays under 60 lines: verified commands, non-obvious conventions and links to existing docs instead of copied prose. @getsentry Apache-2.0 Source getsentry/skills at a582c51
AGENTS.md maintainer
Contributors now arrive with agents. A short AGENTS.md with verified build and test commands is the first file those agents read.
- Archify 4/6 Diagrams Needs app Turns a system description or a real codebase into a checked, standalone HTML diagram you can click through: architecture, workflow, sequence, data flow, ERD and more. @tt-a1i Apache-2.0 Source tt-a1i/archify at 8509a3d
Archify
A clickable architecture diagram drawn from the code, as one HTML file for the docs, so a newcomer sees how the parts connect before reading source.
- webreel 5/6 Official Browser recording Needs app Records scripted browser demos from a JSON config: clicks, typing and scrolling with an animated cursor and a keystroke overlay, exported as MP4, GIF or WebM. @vercel-labs Apache-2.0 Source vercel-labs/webreel at 1504682
webreel
The README GIF, if your project has a web interface. A scripted recording you can run again after every change, with no account and no editor.
- Update changelog 6/6 Release notes Ready Adds what changed since the last release tag to the Unreleased section of your changelog: only notable user-facing changes, in the file's own style, with pull request numbers. @mitsuhiko Apache-2.0 Source mitsuhiko/agent-stuff at 0865c84
Update changelog
Release notes for the first tag and every one after it: the notable user-facing changes since the last tag, written in your changelog's own style.
Good to know
What you bring
- git and bash for the two bundled check scripts
- Optional: gitleaks or trufflehog for the history scan
- GitHub CLI (gh), signed in to your GitHub account
- Node.js 18 or newer
- Chrome, Chromium or Edge for the browser check
- Node.js with npm
Pick one, not both
- README: open-sourcing checks what a README must explain but brings no template. crafting-effective-readmes from softaworks/agent-toolkit has templates by project type. That repository has had no commit since March 2026.
- Licence of the skill: open-sourcing is published under CC BY-SA 4.0, a share-alike licence. That applies to the skill text, not to your project.
- Plugin: in Claude Code, open-sourcing also installs as a plugin from the Trail of Bits marketplace. Use the plugin or the skill, not both.
- Review: find-bugs reports on a branch. review-swarm by Thomas Ricouard reviews a diff with four subagents in parallel. Add one, not both.
- Recording: webreel records a browser. For a command-line tool, record the terminal with a tool of your choice. No card here does that.
- Pull requests: once contributions arrive, pr-writer and iterate-pr in the Pro Developer pack handle your own pull requests.
- Announcement: the launch skill in the Marketer pack plans the announcement, and the Product Launch deck covers a full launch day.
- Every skill file read in full
- Pinned to a reviewed version
- Author and licence on every card
- Requirements and costs disclosed
- No sponsored skills inside
Nov 2026Reviewed