Can I manually change the version in plugin.json?

No, this skill enforces a guardrail that prevents manual edits to ensure version consistency across all repository files via automated scripts.

Are there any exceptions for new skills?

Yes, when creating a new skill with the /create-skill command, the version is manually set to 1.0.0 as an initial starting point.

How is the new version number calculated?

The automated release process calculates the bump based on changelog categories: 'Removed' or 'Changed' trigger Major, 'Added' triggers Minor, and 'Fixed' triggers Patch.

What is the correct workflow for making changes?

Contributors should make their changes, add entries to the [Unreleased] section of the CHANGELOG.md, and submit a PR to the develop branch.

FTC Versioning Guardrail

Name: FTC Versioning Guardrail
Author: ncssm-robotics

byncssm-robotics

•

部署与 DevOps

Enforces automated Semantic Versioning by preventing manual version changes and guiding contributors through the standardized release workflow.

关于

The Versioning Guardrail is a governance skill designed for the FTC Claude plugin marketplace to ensure deterministic and conflict-free releases. It intercepts attempts to manually modify version strings in plugin metadata, instead directing users to follow a changelog-driven workflow where Semantic Versioning (SemVer) increments are automatically calculated. By mapping changelog categories like 'Added' or 'Fixed' to specific version bumps, it guarantees consistency across plugin.json, SKILL.md, and marketplace.json files while preventing the common merge conflicts associated with manual versioning in collaborative environments.

主要功能

Ensures cross-file version synchronization
Integrates with GitHub Actions for automated release PRs
Blocks manual version edits in plugin.json and SKILL.md
2 GitHub stars
Provides standardized commands for changelog updates
Maps changelog categories to Major, Minor, and Patch increments

使用场景

Automating Semantic Versioning based on standardized changelog entries
Managing version consistency across multiple community-contributed FTC plugins
Preventing merge conflicts in high-traffic repositories during release cycles

关于

主要功能

Ensures cross-file version synchronization
Integrates with GitHub Actions for automated release PRs
Blocks manual version edits in plugin.json and SKILL.md
2 GitHub stars
Provides standardized commands for changelog updates
Maps changelog categories to Major, Minor, and Patch increments

使用场景

Automating Semantic Versioning based on standardized changelog entries
Managing version consistency across multiple community-contributed FTC plugins
Preventing merge conflicts in high-traffic repositories during release cycles