⚙️ shipit-skill

Take an existing developer tool from "it works" to "published + listed + marketable" — one pass.

shipit-skill is an Agent Skill that runs the full launch pipeline for AI/developer tools (MCP servers, CLIs, libraries): engineering baseline → publish → directory listings → promo material. It was distilled from shipping wheel-hub, zspace-cli and media-manager-skill — every gotcha below is one that actually bit during those releases.

Install

Two ways to use it — as a CLI tool or as an Agent Skill:

A. CLI (via pip) — for running the pipeline commands yourself:

pip install shipit-skill
shipit-skill init ./my-tool --server my-tool --pkg my-tool   # scaffold CI/Dockerfile/promo
shipit-skill check-promo --dir promo --version 0.1.1 --prs 13600=open

B. Agent Skill — copy this folder into your project (or your agent's skills dir):

cp -r shipit-skill/ ~/your-project/.opencode/skills/shipit-skill   # opencode
# cp -r shipit-skill/ ~/your-project/skills/shipit-skill            # Claude Code, Cursor, etc.

What it does

See SKILL.md for the full agent instructions and the automation boundary (what the agent runs vs. what needs a human/credential).

Example

examples/mcp-server-launch.md walks all four phases against a toy hello-mcp server — reproduce it locally to learn the pipeline before applying it to a real project.

Development

pip install -e ".[dev]"
pytest -q          # 9 tests
ruff check .       # lint

The scars (why this exists)

• mcp>=1.0 + a new SDK → fresh installs crash. Set dependency floors.
• Python 3.9 can't install mcp>=2.0 — split the CI matrix.
• YAML block scalar + inline heredoc = broken workflow. Use a script file.
• Glama introspection needs stdin held open (sleep 1) in smoke tests.
• PyPI tokens start pypi-; UUID-style strings are wrong and 403.
• npm typosquatting blocks similar names — scoped names dodge it.
• Glama builds take minutes to hours — poll, don't panic.

License

MIT