open-sourcing
An agent skill by trailofbits, from trailofbits/skills. Tags: devops, documentation, marketing, security, strategy.
What it does
This skill should be used when the user asks to "open source this project", "prepare this repository for public release", "make this repo public", "check open-source readiness", "choose a license for this project", or "set up release automation" ahead of a public launch. Provides a release-readiness workflow covering secrets hygiene, licensing, documentation, CI, and language-specific packaging.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add trailofbits/skills --skill open-sourcing
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/trailofbits/skills
cp -r skills/plugins/open-sourcing/skills/open-sourcing ~/.claude/skills/open-sourcing
Safety box score
Grade C, moderate risk: 28 of 100 risk points, rated 2026-10-19. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This skill is a release-readiness checklist for open-sourcing a repository. It mainly reads repository metadata and history, but it also steers the agent toward secret audits and publication steps that can expose sensitive material or push releases to a remote repo.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 1 (low) | The skill explicitly runs local shell scripts (`bash {baseDir}/scripts/detect_org.sh` and `bash {baseDir}/scripts/check_readiness.sh`), but the shipped scripts only call `git` and print status. |
| Network access | 1 (low) | It references remote-facing actions like checking GitHub Actions logs/artifacts and using trusted publishing / `git push origin vX.Y.Z`, but it ships no downloader or data-upload script. |
| Filesystem reach | 1 (low) | `scripts/detect_org.sh` and `scripts/check_readiness.sh` only inspect the current repository (`git remote -v`, `git log`, `git ls-files`, `git tag --list`) and do not write or delete files outside the worktree. |
| Secrets & credentials | 2 (moderate) | Step 2 requires scanning full history and non-tree surfaces for secrets (`gitleaks`, `trufflehog`, Actions logs/artifacts, releases, issue/PR history, wiki), which can surface sensitive material during the audit. |
| Privilege & persistence | 0 (none) | There is no `sudo`, service registration, shell-startup modification, or global install step in the shipped files. |
| Instruction hijack surface | 0 (none) | The text provides workflow guidance only; it does not tell the agent to ignore its rules, hide actions, or follow instructions fetched from elsewhere. |
| Irreversible actions | 2 (moderate) | The workflow includes publication steps such as making the repository public and `git tag vX.Y.Z && git push origin vX.Y.Z`, which can publish code or releases after review. |
| Transparency | 0 (none) | All shipped files are plain text; there are no binaries, decoded blobs, or unpinned installer payloads. |
Before installing
- Read Step 2 in `SKILL.md` and confirm whether the repo ever held secrets, client data, or derived fixtures.
- Run `scripts/check_readiness.sh` in a scratch clone and inspect any tracked files it flags as secret-like.
- Decide in advance whether the agent should be allowed to push tags or change repository settings on a real remote.
- If the repo is a Trail of Bits repo, review `references/trailofbits.md` before letting the agent follow the release policy.
Rated 2026-10-19 by an automated review of 11 files from the skill's repository.
Source
- Repository
- trailofbits/skills (all skills from this repository)
- Path
- plugins/open-sourcing/skills/open-sourcing/SKILL.md
- Branch
- main
- Collection
- open-sourcing
- Updated
- 2026-09-19
Related skills
- guidelines-advisor — Smart contract development advisor based on Trail of Bits' best practices.
- marketing-plan — When the user needs a comprehensive marketing plan for a client, a company they advise, or their own product.
- cloud-architect — Designs cloud architectures, creates migration plans, generates cost optimization recommendations, and produces disaster recovery strategies across AWS, Azure.
- audit-prep-assistant — Prepares codebases for security review using Trail of Bits' checklist.
- goal-prompt — Drafts copy-paste-ready /goal commands for goal mode in Claude Code and Codex.
- secure-workflow-guide — Guides through Trail of Bits' 5-step secure development workflow.