publish

Validates READMEs, screenshots, and release surfaces against publish-quality checklists before public release.

1|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/happysasha18/live-spec --skill publish-happysasha18
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: publish
Source: https://github.com/happysasha18/live-spec/tree/main/skills/publish
Command: npx skills add https://github.com/happysasha18/live-spec --skill publish-happysasha18

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Work leaving a machine publicly — a repo going public, a release, a plugin-directory submission — often ships with stale README claims, outdated screenshots, missing install instructions, or leaked secrets. This Skill gates every publication against a checklist keyed to the artifact's kind so the public surface matches what actually shipped. ## Core Features & Use Cases - Kind-based checklists: Enforces what each artifact type owes its reader — skills show install lines and typed commands, tools show a real run with real output, visual products show freshly re-shot screenshots, prose shows its reading path. - Shopfront walk on every version push: Re-reads README claims (behaviour, counts, commands, versions) against the pushed truth and fixes stale claims before the push. - Target-specific steps: Adds per-target requirements for GitHub repos (fresh-clone check, release notes, name-collision checks), plugin directories (manifest validation, listing register), and design projects. - Safety sweeps: Scans tree and history for secrets, personal data, and non-shareable fixtures; enforces impersonal language in shipped docs via guardrail scripts. - Use Case: Before pushing a new version of your CLI tool to GitHub, run the publish walk to catch a README still showing the old version's command syntax, re-shoot a changed screenshot, and verify a fresh clone installs cleanly. ## Quick Start Ask the agent to run the publish checklist on this repository before pushing the new release publicly.

Frequently Asked Questions about publish

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my README is ready before making a repo public?▼

Run the publish walk, which verifies the README's first screen answers what the project is, who it serves, and how to start, and that every claim matches the shipped version. Stale claims, missing install lines, and absent known-issues sections are flagged and fixed before the push.

What should a release checklist include before pushing a new version?▼

A version push triggers the shopfront walk: README claims re-checked against pushed truth, screenshots re-shot if the UI changed, release notes written with an optional offers section, a fresh-clone install test, and a secrets sweep of tree and history.

Does this publish gate replace human approval for releases?▼

No. The skill only prepares the deposit — it runs the checklist, fixes failures, and hands the human a surface already worth approving. The human's publish gate always makes the final release decision, and the skill never sends anything itself.

When should the publish checklist not run?▼

Skip it for in-session work shown to your own human, local commits, and prototypes or sketches that are never published. It fires only when a reader outside the machine will meet the artifact, such as public pushes, releases, or directory submissions.

How are secrets and personal data handled before publishing?▼

The walk sweeps the tree and git history for secrets, tokens, personal paths, and unshareable fixtures, and checks shipped docs for stray personal names using a guardrail script that reports each offence as file:line. Nothing unshareable leaves the machine.