publishing-a-repo
Skill1 starsChanged 3 days agoMITView on GitHub
Check a private repo before its owner makes it public, and report what to fix. Covers secrets in git history, private names and links, licences, security policy, CI exposure to forks, discovery metadata, and a quickstart run from a clean clone. Run only when the user explicitly asks for a pre-publication check, for example "publishing-a-repo", "prepare this repo to go public", "pre-publish check".
- Deletes or force-pushes
- Commits and pushes
In this repository15 other files it gives its agents.
- AGENTS.mdAGENTS.md
- code-auditSkill
- comment-auditSkill
- coordinatorSkill
- correctSkill
- deliverSkill
- handoffSkill
- releaseSkill
- repo-setupSkill
- shared-skillsSkill
- test-auditSkill
- triageSkill
- verification-skillSkill
- writing-docsSkill
- writing-readmesSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 11
Run it only when the user explicitly asks for a pre-publication check.
- Distinctive: line 19
Run all seven. For each, record pass, fail or not checked, with the evidence.
- Distinctive: line 64
Read every workflow file.
- Very specific: line 75
Read reference/discovery.md.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
publishing-a-repo
Prepare a repo for publication and report. The owner changes the visibility. This skill never changes a remote setting and never rewrites history; where either is needed, it gives the exact commands for the owner to run.
Run it only when the user explicitly asks for a pre-publication check. Do not start it because a task mentions a public repo. Work on the current repo unless you are given a path.
Fixes inside the working tree (a removed internal link, a corrected README) are proposed in the report and made only after a yes.
Checks
<skill> in a command is this skill's folder, the one that holds this file. Run those scripts by that path, with the target repo as the working directory.
Run all seven. For each, record pass, fail or not checked, with the evidence.
1. Secrets in the full history
<skill>/scripts/scan-private --historyAlso run a dedicated scanner when one is installed (gitleaks, trufflehog); the script's pattern list is short. Read every secret hit. A hit in an old commit counts: publishing exposes every commit on every branch and tag.
For a real secret, the report says: rotate it first, because a secret that was ever pushed must be treated as leaked. Then, if the owner wants it out of history, propose the commands and do not run them:
git filter-repo --invert-paths --path <file> # or --replace-text <rules file>
git push --force --all && git push --force --tagsState what a rewrite costs: every commit id changes, and every clone and open pull request must be redone. Publishing a fresh repo from a clean export is the alternative.
2. Private references
The same scan lists path, email, host, ticket and author hits across code, docs, commit messages and commit authors. Sort each one:
- Internal hostnames, URLs, wiki and tracker links, ticket ids: fail unless the owner says the target is public.
- Names and emails of people, in files and in commit authorship: list them. Whether each person agreed to be public is the owner's call.
- Home-folder paths, machine names, internal codenames: fail.
Publishing also exposes what is not in the tree: issues, pull requests and their comments (gh issue list --state all, gh pr list --state all), workflow run logs (gh run list), and commits that exist only on the remote. Read them, and list the runs the owner may want deleted first.
Also read by eye what a pattern cannot catch: AGENTS.md and other instruction files, code comments, test fixtures, sample data. Check that git check-ignore -q AGENTS.local.md and git check-ignore -q HANDOFF.md both exit 0 and that neither file was ever committed (git log --all --oneline -- AGENTS.local.md HANDOFF.md prints nothing).
3. Ownership and third-party licences
- Ownership: ask who owns the code (the user, an employer, a client) and whether every author in the
authorlist contributed under terms that allow publication. Record the answer; do not assume it. - Dependencies: list each dependency's licence with the ecosystem's tool (
npm ls --allwith a licence checker,cargo license,pip-licenses,go-licenses) or from the lockfile and package metadata. Flag copyleft and unknown licences against the licence the owner intends. - Copied code: search for vendored folders and for licence headers that differ from the repo's. Each needs its notice kept.
4. Licence, security policy, code of conduct
LICENSE: must exist before publication. If it is missing, report it. Never choose one.SECURITY.md: must name a reporting channel that the owner confirmed in this session. Do not derive one from commit metadata.- Code of conduct: report whether one exists. Adopting one is the owner's decision.
5. CI workflows
Read every workflow file.
- A workflow triggered by
pull_request_target, or byworkflow_runafter a fork's pull request, that checks out or runs the pull request's code can hand secrets to a fork. Fail it. - A
pull_requestjob that needs a secret gets none from a fork and fails. List each such job. - List every secret and variable the workflows name, so the owner can confirm each exists and is scoped.
- Self-hosted runners on a public repo run strangers' code. Fail them.
- Jobs that reach private things (an internal registry, a private submodule, a private action) fail in public. List each.
- Actions pinned to a branch name run whatever that branch becomes. Recommend a tag or a commit.
6. Discovery
Read reference/discovery.md. Check the repo description and topics, the package manifest's description and keywords, the README's first sentence, and llms.txt if a hosted docs site exists. Description and topics are remote settings: propose the values and the command.
7. Quickstart from a clean clone
Clone the repo into a temporary folder (remove it afterwards) with no credentials for anything private and with HOME set to an empty temporary folder, so that an installer cannot touch the real machine, and follow the README quickstart exactly, by a fresh subagent that gets only the README where one is available.
git clone --no-hardlinks . "${TMPDIR:-/tmp}/publish-check" && cd "${TMPDIR:-/tmp}/publish-check"Fail on any step that needs a private registry, a private submodule, an internal host, an unpublished package, or a file that git ignores. If the README has no quickstart, report that and point to writing-readmes.
Report
- A table: each check, its result, and the evidence.
- Blockers, in the order to fix them: secrets, then private references, then licence and ownership.
- Proposed in-repo fixes, for a yes.
Commands for the owner to run, including the last one, which this skill never runs. The flags are those of
gh2.101.0 (2026-09); checkgh repo edit --helpif it differs:gh repo edit <owner>/<repo> --visibility public --accept-visibility-change-consequences- What was not checked, and why.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

