Skip to content

skill-missing-version ​

Skill frontmatter lacks version field

Warning

Rule Details ​

Version numbers help users and Claude track skill updates and ensure compatibility. This rule checks that the version field is present in the SKILL.md frontmatter. Without a version, users cannot tell which iteration of a skill they are running or whether an update has introduced breaking changes.

Incorrect ​

Frontmatter without version field

yaml
---
name: deploy
description: Deploys the application
---

Correct ​

Frontmatter with version field

yaml
---
name: deploy
description: Deploys the application
version: 1.0.0
---

Pre-release version

yaml
---
name: deploy
description: Deploys the application
version: 0.1.0
---

How To Fix ​

Add a version field to the frontmatter section of your SKILL.md file. Use semantic versioning (e.g., version: 1.0.0). Start with 0.1.0 for new skills that are not yet stable.

Options ​

This rule does not have any configuration options.

Resources ​

Version ​

Available since: v0.2.0