publish-repo
Skill0 starsChanged 4 months agoMITView on GitHub
Publishes this Agent Skills repository to skills.sh - pre-flight checks, public visibility flip, protections (PVR, ruleset), consumer-style install verification, telemetry seeding, and repo-page groupings. Use when the user asks to publish, deploy, release, go public, or get listed on skills.sh. Not for authoring skills or editing scaffold infrastructure.
- Commits and pushes
19 other projects use a version of this, 18 of them edited.
Adopted by
Most recently taken up by
- Paldom/mac-os-setup-skillsedited, first seen Oct 13, 2026
- Paldom/python-skillsedited, first seen Sep 10, 2026
- Paldom/node-skillsedited, first seen Sep 10, 2026
- Paldom/storytelling-animationedited, first seen Sep 8, 2026
- Paldom/mobile-app-inspectoredited, first seen Aug 31, 2026
- Paldom/playwright-stealthedited, first seen Aug 31, 2026
Other versions19 projects use a version of this.
Word for word · 0
None found.
Edited · 18
- Paldom/python-skills★ 359% same
- Paldom/github-skills★ 159% same
- Paldom/icon-designer-skills★ 159% same
- Paldom/mobile-app-inspector★ 159% same
- Paldom/node-skills★ 159% same
- Paldom/2fa-agents★ 059% same
- Paldom/databricks-skill-to-app★ 059% same
- Paldom/grill-my-schema★ 059% same
- Paldom/landing-page-builder-skills★ 059% same
- Paldom/llm-council-skills★ 059% same
8 more not listed
Wrote their own version · 1
- lachlanchen/LazySkills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository7 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- add-skillSkill
- engineer-agent-loopSkill
- evaluate-promptsSkill
- optimize-promptSkill
- write-agent-goalSkill
The file
We split this skill into the rules it gives an agent
3 rules. 1 is common, 0 are distinctive, and 2 are very specific to this project.
1
Common
Most of the 19 edited versions we read keep these.
0
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 47
Groupings: ensure skills.sh.json lists every skill in exactly one group with an engaging one-sentence description per group (see …
- Very specific: line 57
Add a default-branch ruleset.
- Common: line 101
Do not enable a require-PR ruleset on a solo repo whose workflow pushes to main directly — it will block the owner.
“Common” is measured: kept by at least 6 in 10 of the 19 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
publish-repo
Deploys this repository to the skills.sh ecosystem. There is no publish API — deployment = a public, installable repo plus a first install that seeds the catalogue telemetry. This skill makes that sequence deliberate instead of ad hoc. Slash-invoked only: it flips repository visibility, which is hard to undo socially (anything ever pushed becomes visible).
When NOT to use
- Writing or fixing a skill →
add-skill. - The repo has zero skills under
skills/→ build first; never publish an empty catalogue. - Routine pushes to an already-public repo → plain git.
Workflow
- Pre-flight (hard gates — stop on any failure): the working tree must be
clean and pushed by the owner — this skill never runs
git commitorgit push; if there are uncommitted changes, stop and hand the list to the owner instead.
Triage everygit status --porcelain # must be empty make check # must end: 0 error(s) npx skills add . --list # every skill under skills/ discovered gh skill publish --dry-run # spec validation (gh >= 2.90; public preview) python3 -c "import json; json.load(open('skills.sh.json'))"gh skillwarning: add missinglicense: MITfrontmatter; the.claude/skills/warning is expected here (bundled first-party dev skills, committed by design — not third-party content). Also verify: README catalogue- CHANGELOG current; every skill description is benefit-led (it is the listing copy); CI green on the latest commit.
- Manual blockers — require explicit user confirmation, never assume:
- full-history secret scan (gitleaks/trufflehog) done;
- personal/private-file review done (everything ever committed goes public).
With
--dry-runin$ARGUMENTS, stop here and report readiness instead.
- Groupings: ensure
skills.sh.jsonlists every skill in exactly one group with an engaging one-sentence description per group (see docs/deploying.md). - Flip visibility (confirm with the user immediately before):
gh repo edit <owner>/<repo> --visibility public --accept-visibility-change-consequences - Protections (public repo unlocks them):
Add a default-branch ruleset. Solo-maintainer default: block force pushes and deletions only (a require-PR rule would block the owner's direct-push workflow); when outside contributors arrive, upgrade to require-PR + code-owner review + thegh api repos/<owner>/<repo>/private-vulnerability-reporting --method PUTvalidatecheck. Also add a tag ruleset onv*(block update + deletion) so published releases are immutable. - Release — cut a versioned GitHub release matching
.claude-plugin/plugin.json:
It re-validates, adds thegh skill publish --tag v<version>agent-skillstopic if missing, and creates the release with auto-generated notes. Add theskills-shtopic too:gh repo edit <owner>/<repo> --add-topic skills-sh. - Verify like a consumer, and seed the catalogue (run locally, NOT in CI —
telemetry is disabled in CI and the first real install is what lists the repo):
npx skills add <owner>/<repo> --list mkdir -p /tmp/skills-verify && cd /tmp/skills-verify npx skills add <owner>/<repo> --skill '*' -a claude-code -y npx skills list -a claude-code - Polish: the README carries the skills.sh badge
(
[](https://skills.sh/<owner>/<repo>)— scaffolded by default); set the homepage (gh repo edit --homepage, e.g. tohttps://skills.sh/<owner>/<repo>); remind about the social preview image (manual UI step). - Report: repo URL, skills.sh page URL, install command, release tag, protections applied, what was skipped (with unlock conditions), and the note that the skills.sh page appears after telemetry processes the seed install (pages are cached).
Output spec
Public repo installable via npx skills add <owner>/<repo> (verified by an
actual install), PVR enabled, ruleset active, skills.sh.json valid with every
skill grouped, seed install performed, user told exactly what to expect next.
Gotchas
- Visibility flip is the point of no return for history — that is why step 2 demands explicit confirmation and never self-certifies.
npx skills add . --listfailing with "No skills found" means frontmatter or layout problems — fix viamake checkoutput, never by restructuring blindly.- The leaderboard/repo page lags the seed install; absence minutes later is normal, not failure.
- Do not enable a require-PR ruleset on a solo repo whose workflow pushes to main directly — it will block the owner; use the staged default in step 5.
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.

