release-and-publish

Automate release publishing to npm, MCP Registry, and GHCR with retry logic.

148|28|Updated Mar 20, 2025
One-click install
npx skills add https://github.com/cyanheads/mcp-ts-core --skill release-and-publish
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-and-publish
Source: https://github.com/cyanheads/mcp-ts-core/tree/main/skills/release-and-publish
Command: npx skills add https://github.com/cyanheads/mcp-ts-core --skill release-and-publish

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates publishing a finalized release across npm, MCP Registry, and GHCR after a complete wrap-up, ensuring coordinated state and verifiable success.

Core Features & Use Cases

  • Validate pre-wrapup requirements (version bump, changelog, commit and tag) and prepare release-ready artifacts.
  • Publish to all destinations with retry logic for transient failures and clear partial-state reporting on unrecoverable errors.
  • Provide idempotent behavior across destinations to avoid duplicates and maintain consistent release state.

Quick Start

Run this skill after completing the git wrap-up to publish the finalized release to npm, the MCP Registry, and GHCR and verify each destination.

Frequently Asked Questions about release-and-publish

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

FAQPage Schema
How do I automate npm and GHCR publishing from a git workflow?

You can automate npm and GHCR publishing by using a workflow that validates pre-wrapup conditions, bumps versions, pushes tags, and coordinates releases with retry logic. This ensures synchronized state across all targets.

What happens if an npm registry publish fails during a multi-target release?

When an npm registry publish fails, the workflow applies retry logic for transient failures. If errors persist, it stops and reports a partial-state outcome, ensuring you know exactly which destinations need intervention.

How do I prevent duplicate package versions when publishing to multiple registries?

To prevent duplicate package versions across multiple registries, the publishing process enforces idempotent behavior. This guarantees that retrying a deployment or re-running the workflow will not create duplicate entries in your destinations.

What's the best way to publish a finalized release to the MCP Registry and npm?

The best way to publish a finalized release to the MCP Registry and npm is to run an automated workflow after git wrap-up. It handles version bumping, changelog updates, and verifies success across all configured destinations.

Why do I need to update the changelog before publishing a package version?

Updating the changelog before publishing a package version is a pre-wrapup requirement. The workflow validates that the changelog is updated alongside the version bump and git tag to ensure release-ready artifacts before deployment.

Can I publish to GHCR and npm simultaneously in one workflow?

Yes, you can publish to GHCR and npm simultaneously within one workflow. The automation coordinates publishing across all targets, applying retry-on-transient-failure logic to manage synchronization and verify each destination.