versioning

Enforce automated version updates across plugin.json, SKILL.md, and marketplace.json.

4|4|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/ncssm-robotics/ftc-claude --skill versioning-ncssm-robotics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: versioning
Source: https://github.com/ncssm-robotics/ftc-claude/tree/main/.claude/skills/versioning
Command: npx skills add https://github.com/ncssm-robotics/ftc-claude --skill versioning-ncssm-robotics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Centralizes and enforces an automated release workflow to prevent manual version bumps across FTC Claude plugins and skills.

Core Features & Use Cases

  • Automated version bumps trigger via the release pipeline when changes are merged.
  • Cross-file consistency checks ensure plugin.json, SKILL.md, and marketplace.json stay synchronized.
  • Audit-ready changelog provides traceability for all version updates and release notes.

Quick Start

Run the release workflow to bump the version whenever a skill or plugin is updated.

Frequently Asked Questions about versioning

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

FAQPage Schema
How do I prevent manual edits to plugin version fields in my repository?

To prevent manual edits to plugin version fields, you need an automated release workflow that enforces version consistency. This Skill blocks direct version updates in plugin.json, SKILL.md, and marketplace.json, ensuring only the release pipeline can modify version fields.

How do I synchronize version numbers across plugin.json, SKILL.md, and marketplace.json?

Synchronizing version numbers across plugin.json, SKILL.md, and marketplace.json requires automated cross-file consistency checks. This Skill validates that all version locations stay aligned during the release pipeline, preventing mismatches between configuration files.

What is automated version bumping and when do I need it for plugin releases?

Automated version bumping is the process of incrementing plugin version numbers through a release pipeline rather than manual edits. You need it when managing multiple plugin and skill files to ensure consistent, traceable version updates across all repository locations.

Does this versioning workflow integrate with existing changelog and release scripts?

Yes, this versioning workflow integrates directly with changelog and release scripts. It ensures the release pipeline updates version fields while simultaneously generating an audit-ready changelog that provides full traceability for all version updates and release notes.

Can I manually update a version field if the automated release workflow is active?

No, you cannot manually update version fields when the automated release workflow is active. This Skill enforces guardrails that block manual edits to version fields in plugin.json, SKILL.md, and marketplace.json, requiring all version bumps to route through the release pipeline.

What's the best way to maintain version consistency across multiple plugin files?

The best way to maintain version consistency across multiple plugin files is enforcing an automated release workflow with cross-file validation. This approach centralizes version control, prevents human error from manual edits, and guarantees synchronization across plugin.json, SKILL.md, and marketplace.json.