open-sourcing — Skillopedia

Open-Sourcing a Repository Prepare a repository for public release so that an outsider with no prior context can build, use, and contribute to it — and so that nothing sensitive ships with it. Work through the steps in order; the secrets audit comes first because its outcome (keeping vs. recreating the repository) affects everything after it. When to Use - Making a private repository public - Auditing an existing public repository for release quality ("make it official") - Choosing a license for a project - Setting up packaging, versioning, or release automation ahead of a public launch When…

|\n grep -vE '\\.(example|sample|template)(\\.|$)'\n}\n\nmain() {\n if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then\n echo \"error: not inside a git repository\" >&2\n exit 1\n fi\n\n echo \"Release-readiness indicators:\"\n check \"README\" exists_any README.md README.rst README.txt README\n check \"LICENSE\" exists_any LICENSE LICENSE.md LICENSE.txt COPYING COPYING.md\n check \"CONTRIBUTING\" exists_any CONTRIBUTING.md CONTRIBUTING.rst .github/CONTRIBUTING.md\n check \"SECURITY policy\" exists_any SECURITY.md .github/SECURITY.md\n check \"Code of conduct\" exists_any CODE_OF_CONDUCT.md .github/CODE_OF_CONDUCT.md\n check \".gitignore\" exists_any .gitignore\n check \".editorconfig\" exists_any .editorconfig\n check \"CI workflows\" has_ci_workflows\n check \"Automated dependency updates (Dependabot/Renovate)\" has_dependency_updates\n check \"Tests\" has_tests\n check \"Semver release tags (vX.Y.Z)\" has_semver_tags\n\n local suspicious\n suspicious=$(list_suspicious_files)\n if [ -n \"${suspicious}\" ]; then\n echo\n echo \"WARNING: tracked files that commonly contain secrets:\"\n printf '%s\\n' \"${suspicious}\" | sed 's/^/ - /'\n echo \"Review these (and full history) before making the repository public.\"\n fi\n}\n\nmain \"$@\"\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":2487,"content_sha256":"19c3eab5f1f158a06ef9a9f56d2dd53e26443b79f64665a865a494baa4174ff4"},{"filename":"scripts/detect_org.sh","content":"#!/usr/bin/env bash\n# Detects whether the current repository belongs to an organization with an\n# additional guidance profile in references/. Prints the profile name\n# (\"trailofbits\" or \"generic\") to stdout.\nset -euo pipefail\n\nTOB_ORGS='trailofbits|lifting-bits|crytic'\n\nremote_matches_tob() {\n git remote -v 2>/dev/null | grep -qiE \"github\\.com[:/](${TOB_ORGS})/\"\n}\n\ncommits_match_tob() {\n git log --format='%ae%n%ce' -n 200 2>/dev/null | grep '@trailofbits\\.com

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

>/dev/null\n}\n\nmain() {\n if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then\n echo \"error: not inside a git repository\" >&2\n exit 1\n fi\n\n if remote_matches_tob || commits_match_tob; then\n echo \"trailofbits\"\n else\n echo \"generic\"\n fi\n}\n\nmain \"$@\"\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":741,"content_sha256":"79d4de769a6f6422be017b7978d95c274fff131d929d74ec0524f2bd971e9bcf"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Open-Sourcing a Repository","type":"text"}]},{"type":"paragraph","content":[{"text":"Prepare a repository for public release so that an outsider with no prior context can build, use, and contribute to it — and so that nothing sensitive ships with it. Work through the steps in order; the secrets audit comes first because its outcome (keeping vs. recreating the repository) affects everything after it.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"When to Use","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Making a private repository public","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Auditing an existing public repository for release quality (\"make it official\")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Choosing a license for a project","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Setting up packaging, versioning, or release automation ahead of a public launch","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"When NOT to Use","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Routine development on an already-released project (no release event)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Auditing third-party code for vulnerabilities (use a security-review skill)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Publishing a package from a repository that will stay private — only the release-management steps apply; skip the rest","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Workflow","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 1: Detect the organization profile","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"sh"},"content":[{"text":"bash {baseDir}/scripts/detect_org.sh","type":"text"}]},{"type":"paragraph","content":[{"text":"The script inspects git remotes and recent committer emails, and prints a profile name. If it prints ","type":"text"},{"text":"trailofbits","type":"text","marks":[{"type":"code_inline"}]},{"text":", read ","type":"text"},{"text":"references/trailofbits.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/trailofbits.md","title":null}}]},{"text":" now and apply its license policy, publishing accounts, and process notes throughout the remaining steps. If it prints ","type":"text"},{"text":"generic","type":"text","marks":[{"type":"code_inline"}]},{"text":", proceed with the generic guidance alone. If the user says the detection is wrong, trust the user.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 2: Audit for secrets — before anything else","type":"text"}]},{"type":"paragraph","content":[{"text":"A repository that has ","type":"text"},{"text":"ever","type":"text","marks":[{"type":"strong"}]},{"text":" contained secrets (API keys, credentials, client data) should not be flipped public. History rewriting is error-prone and does not reach forks, caches, or CI artifacts. The reliable fix is a fresh repository: copy the current tree over, commit, and archive the old repository privately.","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Ask whether the project ever handled secrets or client-confidential material. For a security consultancy's tooling, also ask whether test fixtures or example data came from client engagements.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Scan the full history with a dedicated tool if available — ","type":"text"},{"text":"gitleaks git .","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"trufflehog git file://.","type":"text","marks":[{"type":"code_inline"}]},{"text":" — rather than eyeballing.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check beyond the git tree: GitHub Actions logs and artifacts, old releases, issue and PR history, and the repository wiki all become public with the repository.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"After going public, enable GitHub secret scanning and push protection in the repository settings.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Reject these rationalizations — this is the one step that cannot be fixed after publication:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"The key was revoked, so the history is fine.\"","type":"text","marks":[{"type":"em"}]},{"text":" Revoked credentials still leak infrastructure names, internal URLs, and patterns attackers use for targeting.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"We'll rewrite history with git-filter-repo.\"","type":"text","marks":[{"type":"em"}]},{"text":" Rewrites miss forks, clones, caches, and CI artifacts; the fresh-repository approach does not.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"It's only test data.\"","type":"text","marks":[{"type":"em"}]},{"text":" Fixtures derived from client engagements or production systems are confidential regardless of how they are labeled.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 3: Run the readiness check","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"sh"},"content":[{"text":"bash {baseDir}/scripts/check_readiness.sh","type":"text"}]},{"type":"paragraph","content":[{"text":"The script prints a checklist of presence indicators (README, LICENSE, CONTRIBUTING, SECURITY.md, CI, tests, semver tags, ...) and warns about tracked files that commonly contain secrets. Treat unchecked items as discussion prompts, not hard failures — a research prototype does not need everything a flagship library needs. Walk through the gaps with the user and fix the ones that matter for this project.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 4: Documentation","type":"text"}]},{"type":"paragraph","content":[{"text":"The README is the project's front door. Confirm it explains:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What the project is","type":"text","marks":[{"type":"strong"}]},{"text":" and what problem it solves (first paragraph)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"How to install it","type":"text","marks":[{"type":"strong"}]},{"text":" — package manager, container image, or build from source; a fresh-clone build must work using only what is in the repository","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"How to use it","type":"text","marks":[{"type":"strong"}]},{"text":" — at least one concrete, copy-pasteable example","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"How to contribute","type":"text","marks":[{"type":"strong"}]},{"text":" — inline or via ","type":"text"},{"text":"CONTRIBUTING.md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"The license","type":"text","marks":[{"type":"strong"}]},{"text":" — a short section naming it","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Also add:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"SECURITY.md","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" with vulnerability-reporting instructions (a contact address or GitHub private vulnerability reporting). For security tooling this is table stakes.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"API documentation","type":"text","marks":[{"type":"strong"}]},{"text":", built and hosted (GitHub Pages via CI is the usual route), linked from the README and the repository website field. See the language references below for per-ecosystem doc tooling.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"A ","type":"text"},{"text":"code of conduct","type":"text","marks":[{"type":"strong"}]},{"text":" if the project expects outside contributors.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 5: Licensing","type":"text"}]},{"type":"paragraph","content":[{"text":"No license means not open source, regardless of visibility. Read ","type":"text"},{"text":"references/licensing.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/licensing.md","title":null}}]},{"text":" for selection criteria and mechanics. The short version:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Apply the organization's policy if one was detected in Step 1.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Otherwise: Apache 2.0 as the permissive default, AGPLv3 when private modification by competitors is a real concern, Creative Commons for non-code artifacts.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Add the ","type":"text"},{"text":"LICENSE","type":"text","marks":[{"type":"code_inline"}]},{"text":" file, set SPDX identifiers in package metadata, state the license in the README, and verify all three agree.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 6: Tests and CI","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Confirm the test suite exists and passes; a public repository with a failing default branch signals abandonment.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Ensure CI runs the tests on every PR, across the supported language-version and platform matrix.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Enforce formatting and linting in CI (per-language tooling in the references below), so style debates never reach review.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Respect existing tooling.","type":"text","marks":[{"type":"strong"}]},{"text":" Do not replace a working formatter, linter, or type checker as part of open-sourcing. If it lags the current generation (the language references name the current tools), warn the maintainer and let them decide; only when a category is missing entirely — no type checker, no formatter — add the current default.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Consider a coverage gate that fails CI when coverage drops.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Harden the workflows themselves before they become public attack surface:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Pin third-party actions to full commit SHAs; enable Dependabot for ","type":"text"},{"text":"github-actions","type":"text","marks":[{"type":"code_inline"}]},{"text":" so pins stay current.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Set least-privilege ","type":"text"},{"text":"permissions:","type":"text","marks":[{"type":"code_inline"}]},{"text":" blocks (start from ","type":"text"},{"text":"permissions: {}","type":"text","marks":[{"type":"code_inline"}]},{"text":").","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Audit with ","type":"text"},{"text":"zizmor .github/workflows/","type":"text","marks":[{"type":"code_inline"}]},{"text":" and lint with ","type":"text"},{"text":"actionlint","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 7: Repository settings","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Branch protection","type":"text","marks":[{"type":"strong"}]},{"text":" on the default branch: no force pushes, PRs required. Prefer rulesets for new repositories; classic branch protection remains supported.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Merge protection","type":"text","marks":[{"type":"strong"}]},{"text":": required status checks so PRs cannot merge with failing tests.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Dependabot or Renovate","type":"text","marks":[{"type":"strong"}]},{"text":" for dependency and Actions updates. Group updates to cut PR noise, and set a cooldown window (e.g., 7 days) so freshly published — and occasionally hijacked — versions age before adoption.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":".editorconfig","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" so contributors' editors agree on whitespace basics.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Labels","type":"text","marks":[{"type":"strong"}]},{"text":": create them as soon as more than one issue or PR needs one; prefixes for facets scale well (","type":"text"},{"text":"C:","type":"text","marks":[{"type":"code_inline"}]},{"text":" component, ","type":"text"},{"text":"P:","type":"text","marks":[{"type":"code_inline"}]},{"text":" platform). See ","type":"text"},{"text":"blight's labels","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/trailofbits/blight/labels","title":null}}]},{"text":" for a worked example.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 8: Releases and versioning","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Tag every release ","type":"text"},{"text":"vX.Y.Z","type":"text","marks":[{"type":"code_inline"}]},{"text":", following ","type":"text"},{"text":"semver","type":"text","marks":[{"type":"link","attrs":{"href":"https://semver.org/","title":null}}]},{"text":"; use ","type":"text"},{"text":"-rc.N","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"-pre.N","type":"text","marks":[{"type":"code_inline"}]},{"text":" suffixes for release candidates and prereleases.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Make releases CI-driven: pushing a tag (or publishing a GitHub Release) triggers build, packaging, and upload with no manual steps. A release should be ","type":"text"},{"text":"git tag vX.Y.Z && git push origin vX.Y.Z","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Publish packages under an organization-owned account, not a personal one, and use ","type":"text"},{"text":"trusted publishing","type":"text","marks":[{"type":"strong"}]},{"text":" (OIDC) instead of long-lived tokens wherever the index supports it.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 9: Language-specific practices","type":"text"}]},{"type":"paragraph","content":[{"text":"Identify the project's languages from its marker files and read the matching reference for packaging, publishing, and quality tooling:","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Marker file","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Reference","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"pyproject.toml","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"setup.py","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"references/python.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/python.md","title":null}}]},{"text":" — defers to the modern-python skill for tooling","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"CMakeLists.txt","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Makefile","type":"text","marks":[{"type":"code_inline"}]},{"text":" (C/C++)","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"references/c-cpp.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/c-cpp.md","title":null}}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Cargo.toml","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"references/rust.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/rust.md","title":null}}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"go.mod","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"references/go.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/go.md","title":null}}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"package.json","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"references/javascript.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/javascript.md","title":null}}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Gemfile","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"*.gemspec","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"references/ruby.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/ruby.md","title":null}}]}]}]}]}]},{"type":"paragraph","content":[{"text":"For other ecosystems, apply the cross-cutting principles: reproducible builds from a fresh clone, CI-driven releases, trusted publishing or organization-owned accounts, and license metadata in the package manifest.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Final Review","type":"text"}]},{"type":"paragraph","content":[{"text":"Before the visibility switch is flipped, verify from an outsider's perspective:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Clone into a clean directory and follow the README's build instructions verbatim — do they work with no tribal knowledge?","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Re-run ","type":"text"},{"text":"{baseDir}/scripts/check_readiness.sh","type":"text","marks":[{"type":"code_inline"}]},{"text":" and confirm the remaining gaps are deliberate choices, stated to the user.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Confirm the secrets audit (Step 2) actually happened; it is the one step that cannot be fixed after publication.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Making the repository public is then a repository-settings change. Pair the release with an announcement where the organization has a process for one.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Additional Resources","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Reference Files","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/licensing.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/licensing.md","title":null}},{"type":"strong"}]},{"text":" — license selection criteria, SPDX metadata, forks and relicensing","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/trailofbits.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/trailofbits.md","title":null}},{"type":"strong"}]},{"text":" — Trail of Bits policy overlay (loaded only when detected in Step 1)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/python.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/python.md","title":null}},{"type":"strong"}]},{"text":", ","type":"text"},{"text":"references/c-cpp.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/c-cpp.md","title":null}},{"type":"strong"}]},{"text":", ","type":"text"},{"text":"references/rust.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/rust.md","title":null}},{"type":"strong"}]},{"text":", ","type":"text"},{"text":"references/go.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/go.md","title":null}},{"type":"strong"}]},{"text":", ","type":"text"},{"text":"references/javascript.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/javascript.md","title":null}},{"type":"strong"}]},{"text":", ","type":"text"},{"text":"references/ruby.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/ruby.md","title":null}},{"type":"strong"}]},{"text":" — per-language packaging, publishing, and quality tooling","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Scripts","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"scripts/detect_org.sh","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" — prints the organization profile (","type":"text"},{"text":"trailofbits","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"generic","type":"text","marks":[{"type":"code_inline"}]},{"text":") from git remotes and committer emails","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"scripts/check_readiness.sh","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" — prints presence indicators for release-readiness files and flags tracked files that commonly hold secrets","type":"text"}]}]}]}]},"metadata":{"date":"2026-11-02","name":"open-sourcing","author":"@skillopedia","source":{"stars":7957,"repo_name":"skills","origin_url":"https://github.com/trailofbits/skills/blob/HEAD/plugins/open-sourcing/skills/open-sourcing/SKILL.md","repo_owner":"trailofbits","body_sha256":"da8d876edfc13f234cb88a2531da86a5e37d417d63d5c4b174ad18b6a20e0c53","cluster_key":"658b94fea7ab0418b17681f0ddf8136bc8b83ad64062160f2da388bab81298c8","clean_bundle":{"format":"clean-skill-bundle-v1","source":"trailofbits/skills/plugins/open-sourcing/skills/open-sourcing/SKILL.md","text_bytes":26493,"source_commit":"d016e08cc7408ecb1853a299d06d4a56e363ad5e","skills_sh_rank":9998,"attachment_count":10,"text_attachments":10,"attachment_storage":"skill_attachments","binary_attachments":0},"cluster_size":1,"skill_md_path":"plugins/open-sourcing/skills/open-sourcing/SKILL.md","import_metadata":{"date":"2026-11-02","author":"@skillopedia","version":"v1","category":"devops-infrastructure","category_label":"DevOps"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"devops-infrastructure","import_tag":"skills-sh-top20k-2026-11","description":"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."}},"renderedAt":1793666398374}

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.