Skip to content

sekar3s/ship-ready

v1.0.0MIT

Release-readiness copilot: go/no-go checks, semver suggestions, changelog drafts, and guardrails for risky release commands.

🚀 ship-ready

Release-readiness copilot. Decide Go/No-Go with evidence, get a semantic version recommendation and a draft changelog, and add guardrails around risky release commands in every Copilot client.

Version1.0.0
FormatAgent Plugins 1.0 + com.github.copilot extensions
Works inVS Code · GitHub Copilot CLI · GitHub Copilot app
RequiresNode.js 18+ and git on PATH
Network accessNone. Read-only analysis of your local git repository

What's inside

ComponentNameLocationPortable?
Skillrelease-readinessskills/release-readiness/✅ Agent Plugins standard
MCP serverrelease-radar (stdio)mcp.json → servers/release-radar.mjs✅ Agent Plugins standard
Custom agentrelease-captaincom.github.copilot/agents/Copilot clients
HookssessionStart, preToolUsecom.github.copilot/hooks/hooks.jsonCopilot clients
Slash command/ship-checkcom.github.copilot/commands/Copilot clients
Automation templateWeekly release readinessautomations/VS Code only

release-radar MCP tools (all read-only)

ToolWhat it returns
check_release_artifactsChecklist (changelog, clean tree, branch, CI, tests, lockfiles, version consistency, migrations, README/LICENSE/SECURITY, TODO markers) and a GO / GO WITH CAUTION / NO-GO verdict
suggest_semver_bumpCurrent → next version with rationale (Conventional Commits, with heuristics for other commit styles)
commits_since_last_tagClassified commits since the last tag
draft_changelogKeep-a-Changelog style markdown for the next release

Hooks

EventBehavior
sessionStartAdds release context: branch, last tag, unreleased commits, uncommitted changes
preToolUseAsks for confirmation (ask) before force-pushes, pushes to main/release/*, git tag, git push --tags, npm/pnpm/yarn publish, gh release create/edit/delete, docker push, and npm version

Install

# Copilot CLI (the GitHub Copilot app uses the same plugins)
copilot plugin marketplace add sekar3s/octocat-agent-plugins-demo
copilot plugin install ship-ready@octocat-agent-plugins

In VS Code, add "chat.plugins.marketplaces": ["sekar3s/octocat-agent-plugins-demo"] to your settings, search @agentPlugins ship-ready in the Extensions view, and select Install. In the GitHub Copilot app, go to Customize → Plugins and add the marketplace. See the installation guide for all options, including enterprise rollout.

Use it

Try thisWhere
/ship-checkAny client
"Are we ready to release? What version should this be?"Any client (the skill loads automatically)
Select the release-captain agent and ask for a release planVS Code agent picker · CLI /agent or copilot --agent ship-ready:release-captain · Copilot app agent picker
Templates from Plugins → Weekly release readinessVS Code Agents window → Automations
node skills/release-readiness/scripts/readiness-report.mjs --path <repo>Terminal (no AI needed)

Configuration

VariableDefaultEffect
SHIP_READY_GUARDonSet to off to disable the preToolUse confirmation guard
OCTOCAT_PLUGINS_AUDIT_DIRunsetWhen set, guard decisions are appended to <dir>/ship-ready.jsonl (local only)

Remove

copilot plugin uninstall ship-ready

In VS Code, right-click ship-ready in Agent Plugins - Installed and select Uninstall. See the uninstall guide.