Skip to content

sekar3s/ship-ready

v1.1.0MIT

Release-readiness toolkit: scores your repo 0-100 via MCP, drafts audience-friendly release notes with a skill, recommends the next semantic version, and audits every agent tool call with hooks.

🚢 Ship-Ready

A release-readiness toolkit. It scores your repository, recommends the next semantic version, writes release notes people actually read, and keeps an audit trail of every tool call the agent makes.

ComponentTypeWhereWhat it does
release-notesSkill (portable)skills/release-notes/Turns commits into audience-friendly notes (highlights, breaking changes + migration, contributors). Ships a self-contained collect-commits.mjs script.
ship-readyMCP server (portable, local stdio, zero dependencies)mcp.json → mcp/server.mjsreadiness_scan (0–100 score + grade across docs, security, quality, delivery) · changelog_from_git · suggest_version_bump
release-captainCustom agent (Copilot)com.github.copilot/agents/Readiness → version → changes → release notes → 🟢/🟡/🔴 go/no-go
Release contextHook sessionStart (Copilot)scripts/session-context.mjsAdds branch, ahead/behind, uncommitted changes and commits since the last tag to the agent's context
Audit trailHook postToolUse (Copilot)scripts/audit-tool.mjsAppends every tool call (tool, target, result) as JSON lines to ~/.agent-plugins-demo/ship-ready/audit.log
weekly-release-readinessAutomation template (VS Code)com.github.copilot/automations/Every Friday 16:00: readiness score, version recommendation and draft notes

Install

copilot plugin marketplace add sekar3s/copilot-agent-plugins-demo
copilot plugin install ship-ready@copilot-agent-plugins-demo

In VS Code, add "chat.plugins.marketplaces": ["sekar3s/copilot-agent-plugins-demo"] to your settings, install from the Extensions view (@agentPlugins), and use the Copilot session target. For the GitHub Copilot app and more options, see the root README.

Try it

PromptShows
Select release-captain → Are we ready to ship?Agent + MCP + skill working together
What's our release readiness score?MCP tool readiness_scan
Draft release notes for v1.1.0Skill release-notes
What version should we release next?MCP tool suggest_version_bump
tail -f ~/.agent-plugins-demo/ship-ready/audit.log in a terminalpostToolUse hook auditing live

The CLI names plugin agents <plugin>:<agent>: copilot --agent ship-ready:release-captain.

Readiness checks

AreaChecks (weight)
DocsREADME with content (10) · LICENSE (5) · CHANGELOG (5) · CONTRIBUTING (3)
SecuritySECURITY.md (5) · no tracked .env (7) · .gitignore covers .env/deps (3) · Dependabot/Renovate (5)
QualityTests present (12) · test ratio ≥ 0.2 (5) · build/test/lint scripts (8) · ≤ 10 TODO/FIXME (5)
DeliveryCI workflow (10) · lockfile (5) · clean working tree (7) · CODEOWNERS (3)

Grade: A ≥ 90 · B ≥ 80 · C ≥ 70 · D ≥ 60 · F < 60.