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