skill-version
Skill version must follow semantic versioning format (e.g., 1.0.0)
Rule Details
The version frontmatter field communicates the skill's release state to users. When present, it must follow semantic versioning format (e.g., 1.0.0, 0.3.1). This rule delegates to the skill frontmatter Zod schema for validation. Invalid version strings prevent proper version tracking and dependency resolution. The field is optional; this rule only fires when it is present but malformed.
Incorrect
Version missing patch number
---
name: deploy-app
version: 1.0
---Version with non-numeric components
---
name: deploy-app
version: v1.0.0
---Arbitrary string as version
---
name: deploy-app
version: latest
---Correct
Standard semantic version
---
name: deploy-app
version: 1.0.0
---Pre-release semantic version
---
name: deploy-app
version: 0.3.1
---No version field (version is optional)
---
name: deploy-app
description: Deploys the application
---How To Fix
Set the version field to a valid semantic version string in MAJOR.MINOR.PATCH format (e.g., 1.0.0). Do not include a "v" prefix or use partial version numbers.
Options
This rule does not have any configuration options.
Related Rules
Resources
Version
Available since: v0.2.0