mkpublisted

Generates and updates a repository's four public-facing docs — README.md, LICENSE.md, SECURITY.md, and llms.txt — from a scan of the repo itself. The README uses a figlet-rendered centered header and badgen badges. Use when the user says "write a README", "generate docs for this repo", "add a license", "add a security policy", "add llms.txt", "/mkpub", or asks to document a repository or skill for release.
ndisisnd/mkpub · ★ 0 · AI & Automation · score 73

Install: claude install-skill ndisisnd/mkpub

# mkpub Writes the four files a public repo needs before strangers land on it: `README.md`, `LICENSE.md`, `SECURITY.md`, `llms.txt`. Built for skill repos, works on any repo. This file routes. The actual instructions live in `refs/protocol-*.md` — read the protocol for each mode you're running, and read nothing else. ## Modes **Writes files:** | Invocation | What it does | Protocol | |---|---|---| | `/mkpub` or `/mkpub --init` | All four files, README written last | every protocol below — see Step 3 for order | | `/mkpub --readme` | `README.md` — figlet header, badges, seven sections | `refs/protocol-readme.md` | | `/mkpub --license` | `LICENSE.md` — asks which license first, never infers | `refs/protocol-license.md` | | `/mkpub --security` | `SECURITY.md` — reporting channel and supported versions | `refs/protocol-security.md` | | `/mkpub --llms` | `llms.txt` — an index for agents landing in the repo | `refs/protocol-llms.md` | | `/mkpub --update` | Re-scans and refreshes only what actually drifted | `refs/protocol-update.md` | **Prints to the terminal only — writes nothing:** | Invocation | What it does | Protocol | |---|---|---| | `/mkpub --desc` | A GitHub repo description, ready to paste | `refs/protocol-desc.md` | | `/mkpub --tag` | GitHub topic tags, ready to paste | `refs/protocol-tag.md` | | `/mkpub --help` | This menu | none — see below | Flags combine: `/mkpub --readme --llms` runs both protocols. `--init` does **not** include `--desc` or `--tag` — they pro