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.

주요 기능

01Ensures cross-file version synchronization

02Integrates with GitHub Actions for automated release PRs

03Blocks manual version edits in plugin.json and SKILL.md

042 GitHub stars

05Provides standardized commands for changelog updates

06Maps changelog categories to Major, Minor, and Patch increments

사용 사례

01Automating Semantic Versioning based on standardized changelog entries

02Managing version consistency across multiple community-contributed FTC plugins

03Preventing merge conflicts in high-traffic repositories during release cycles

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ncssm-robotics/ftc-claude versioning

For use in Claude.ai and ChatGPT

Download Skill