Skip to content
cccskills
FreePublished on GitHub

release-standards

Semantic versioning and changelog formatting for software releases. Use when: preparing releases, updating version numbers, writing changelogs. Keywords: version, release, changelog, semver, major, minor, patch, 版本, 發布, 變更日誌.

The English summary is being prepared. Showing the original description.

See how to install

Files included (3)

  • SKILL.md3.5 KB
  • changelog-format.md4.6 KB
  • semantic-versioning.md4.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Release Standards

This skill provides semantic versioning and changelog formatting standards.

Quick Reference

Semantic Versioning Format

MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]

Examples:
2.3.1
1.0.0-alpha.1
3.2.0-beta.2+20250112

Version Incrementing Rules

ComponentWhen to IncrementExample
MAJORBreaking changes1.9.5 → 2.0.0
MINORNew features (backward-compatible)2.3.5 → 2.4.0
PATCHBug fixes (backward-compatible)3.1.2 → 3.1.3

Pre-release Identifiers

IdentifierStabilityAudience
alphaUnstableInternal team
betaMostly stableEarly adopters
rcStableBeta testers

CHANGELOG Categories

CategoryUsage
AddedNew features
ChangedChanges in existing functionality
DeprecatedSoon to be removed
RemovedRemoved features
FixedBug fixes
SecurityVulnerability fixes

Detailed Guidelines

For complete standards, see:

CHANGELOG Entry Format

## [VERSION] - YYYY-MM-DD

### Added
- Add user dashboard with customizable widgets (#123)

### Changed
- **BREAKING**: Change API response format from XML to JSON

### Fixed
- Fix memory leak when processing large files (#456)

### Security
- Fix SQL injection vulnerability (CVE-2025-12345)

Breaking Changes

Mark breaking changes with BREAKING prefix:

### Changed
- **BREAKING**: Remove deprecated `getUserById()`, use `getUser()` instead

Git Tagging

# Create annotated tag (recommended)
git tag -a v1.2.0 -m "Release version 1.2.0"

# Push tag to remote
git push origin v1.2.0

Version Ordering

1.0.0-alpha.1 < 1.0.0-alpha.2 < 1.0.0-beta.1 < 1.0.0-rc.1 < 1.0.0

Configuration Detection

This skill supports project-specific configuration.

Detection Order

  1. Check CONTRIBUTING.md for "Disabled Skills" section
    • If this skill is listed, it is disabled for this project
  2. Check CONTRIBUTING.md for "Release Standards" section
  3. If not found, default to Semantic Versioning and Keep a Changelog format

First-Time Setup

If no configuration found and context is unclear:

  1. Ask the user: "This project hasn't configured release standards. Would you like to use Semantic Versioning?"
  2. After user selection, suggest documenting in CONTRIBUTING.md:
## Release Standards

### Versioning
This project uses **Semantic Versioning** (MAJOR.MINOR.PATCH).

### Changelog
This project follows **Keep a Changelog** format.

Configuration Example

In project's CONTRIBUTING.md:

## Release Standards

### Versioning
This project uses **Semantic Versioning** (MAJOR.MINOR.PATCH).

### Changelog
This project follows **Keep a Changelog** format.

### Release Process
1. Update version in package.json
2. Update CHANGELOG.md
3. Create git tag with `v` prefix (e.g., v1.2.0)
4. Push tag to trigger release workflow

License: CC BY 4.0 | Source: universal-dev-standards

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Prevent AI hallucination and ensure evidence-based responses when analyzing code or making suggestions. Use when: analyzing code, making recommendations, providing options, or when user asks about confidence/certainty. Keywords: certainty, assumption, inference, evidence, source, 確定性, 推測, 假設, 來源, 證據.

The English summary is being prepared. Showing the original description.

AsiaOstrich/universal-dev-skills43Updated Dec 30, 2025

Systematic code review checklist and pre-commit quality gates for PRs. Use when: reviewing pull requests, checking code quality, before committing code. Keywords: review, PR, pull request, checklist, quality, commit, 審查, 檢查, 簽入.

The English summary is being prepared. Showing the original description.

AsiaOstrich/universal-dev-skills43Updated Dec 30, 2025

Format commit messages following conventional commits standard. Use when: writing commit messages, git commit, reviewing commit history. Keywords: commit, git, message, conventional, 提交, 訊息, feat, fix, refactor.

The English summary is being prepared. Showing the original description.

AsiaOstrich/universal-dev-skills43Updated Dec 30, 2025

Guide documentation structure, README content, and project documentation best practices. Use when: creating README, documentation, docs folder, project setup. Keywords: README, docs, documentation, CONTRIBUTING, CHANGELOG, 文件, 說明文件.

The English summary is being prepared. Showing the original description.

AsiaOstrich/universal-dev-skills43Updated Dec 30, 2025

Guide Git branching strategies, branch naming, and merge operations. Use when: creating branches, merging, pull requests, Git workflow questions. Keywords: branch, merge, PR, pull request, GitFlow, GitHub Flow, 分支, 合併, 工作流程.

The English summary is being prepared. Showing the original description.

AsiaOstrich/universal-dev-skills43Updated Dec 30, 2025

Guide requirement writing, user story creation, and feature specification. Use when: writing requirements, user stories, issues, feature planning. Keywords: requirement, user story, issue, feature, specification, 需求, 功能規劃, 規格.

The English summary is being prepared. Showing the original description.

AsiaOstrich/universal-dev-skills43Updated Dec 30, 2025

See all skills by AsiaOstrich

Report a problem with this skill