oss-publish

Drafts changelog entries, confirms SemVer bumps, and tags releases to trigger GitHub release workflows.

31|2|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/letuhao/lore-weave --skill oss-publish-letuhao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oss-publish
Source: https://github.com/letuhao/lore-weave/tree/main/.claude/skills/oss-publish
Command: npx skills add https://github.com/letuhao/lore-weave --skill oss-publish-letuhao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Cutting a release involves drafting a changelog from merged work, choosing the correct SemVer bump, and tagging in the right order — doing these out of sequence or guessing the version publishes a tag nobody actually chose. This Skill enforces the correct sequence with human confirmation at the critical points. ## Core Features & Use Cases - Changelog drafting: Gathers merged PRs and commits since the last tag, classifies them into Keep a Changelog buckets (Added/Changed/Fixed/Removed/Security), and summarizes dependency bumps into a single line. - Human-confirmed versioning: Uses an explicit question to confirm PATCH, MINOR, or pre-release bumps — never infers a version silently, and treats the first release as v0.1.0. - Gated tag and push: Validates CHANGELOG.md with a structural gate script before committing, tagging, and pushing to trigger the oss-release.yml workflow that builds images and publishes the GitHub Release. - Use Case: After merging a sprint of features, ask what changed since the last tag, review the drafted changelog, confirm a MINOR bump to v0.3.0, and push the tag to publish the release. ## Quick Start Ask the assistant to cut a release for the current repository and walk through drafting the changelog, confirming the version, and pushing the tag.

Frequently Asked Questions about oss-publish

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

FAQPage Schema
How do I cut a release with an automated changelog?

Run the release skill to gather merged PRs and commits since the last tag, classify them into Keep a Changelog sections, and draft the new version entry. After you confirm the SemVer bump, it validates the changelog, commits, tags, and pushes to trigger the release workflow.

How do I decide between a PATCH and MINOR version bump?

Under SemVer with a pre-1.0 major version, PATCH covers fixes and dependency bumps only, while MINOR covers new features or any breaking change. The skill asks you to confirm the choice explicitly rather than inferring it from commit prefixes.

What triggers the GitHub Release workflow?

Pushing an annotated v* tag triggers the oss-release.yml workflow, which builds the Docker images and publishes the GitHub Release. The workflow fails closed at a changelog gate if CHANGELOG.md is structurally invalid.

Why does the changelog gate script fail before tagging?

The changelog-gate.py script fails when CHANGELOG.md has structural problems, such as malformed version sections or missing subheadings. Fix the file structure and re-run the check before committing or tagging — the same check runs again in the release workflow.

Can I check what changed since the last release without tagging?

Yes, pass the 'check' argument to report the last tag, the current Unreleased changelog contents, and whether the changelog is structurally clean. It stops there without drafting entries or creating any tag.