Skip to content

Commit 254b168

Browse files
sjnimsclaude
andcommitted
fix(skills): remove version field from skill frontmatter examples
Version is optional for skills, not required. Updated all documentation and examples to reflect this: - Remove version from skill YAML frontmatter examples - Update workflow checks to note version is optional - Remove skills from version consistency checks - Fix skill names to use kebab-case in examples 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 59875ca commit 254b168

7 files changed

Lines changed: 7 additions & 11 deletions

File tree

.github/workflows/claude-pr-review.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ jobs:
6464
6565
### Plugin Components (if changed)
6666
- **Commands** (`commands/*.md`): Verify YAML frontmatter has name, description, allowed-tools. Check for imperative voice ("Do X" not "You should do X").
67-
- **Skills** (`skills/*/SKILL.md`): Check trigger phrases in description, version in frontmatter, progressive disclosure pattern.
67+
- **Skills** (`skills/*/SKILL.md`): Check trigger phrases in description, progressive disclosure pattern (name and description required in frontmatter; version is optional).
6868
- **Agents** (`agents/*.md`): Verify <example> blocks for triggering, appropriate tool restrictions.
6969
- **Hooks** (`hooks/hooks.json`): Validate event types and matcher patterns.
7070

.github/workflows/weekly-maintenance.yml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,8 @@ jobs:
5050
Check that all version files match:
5151
- `plugins/plugin-dev/.claude-plugin/plugin.json` (source of truth)
5252
- `.claude-plugin/marketplace.json` (both metadata.version and plugins[0].version)
53-
- All 7 skill SKILL.md files in `plugins/plugin-dev/skills/*/SKILL.md`
53+
54+
Note: Skills do NOT have a version field (version is optional for skills and not used in this plugin).
5455
5556
Read each file and extract the version. Report if any mismatch.
5657

CONTRIBUTING.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -184,9 +184,8 @@ When creating or modifying skills:
184184
1. **YAML Frontmatter Required**:
185185
```yaml
186186
---
187-
name: Skill Name
187+
name: skill-name
188188
description: This skill should be used when the user asks to "trigger phrase 1"...
189-
version: 0.1.0
190189
---
191190
```
192191

plugins/plugin-dev/skills/plugin-structure/README.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -105,5 +105,4 @@ To update this skill:
105105
1. Keep SKILL.md lean and focused on core concepts
106106
2. Move detailed information to references/
107107
3. Add new examples/ for common patterns
108-
4. Update version in SKILL.md frontmatter
109-
5. Ensure all documentation uses imperative/infinitive form
108+
4. Ensure all documentation uses imperative/infinitive form

plugins/plugin-dev/skills/plugin-structure/SKILL.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -195,7 +195,6 @@ skills/
195195
---
196196
name: Skill Name
197197
description: When to use this skill
198-
version: 1.0.0
199198
---
200199

201200
Skill instructions and guidance...

plugins/plugin-dev/skills/plugin-structure/examples/advanced-plugin.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -311,9 +311,8 @@ await SlackClient.notify({
311311

312312
```markdown
313313
---
314-
name: Kubernetes Operations
314+
name: kubernetes-ops
315315
description: This skill should be used when deploying to Kubernetes, managing K8s resources, troubleshooting cluster issues, configuring ingress/services, scaling deployments, or working with Kubernetes manifests. Provides comprehensive Kubernetes operational knowledge and best practices.
316-
version: 2.0.0
317316
---
318317

319318
# Kubernetes Operations

plugins/plugin-dev/skills/plugin-structure/examples/standard-plugin.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -225,9 +225,8 @@ Generated tests include:
225225

226226
```markdown
227227
---
228-
name: Code Standards
228+
name: code-standards
229229
description: This skill should be used when reviewing code, enforcing style guidelines, checking naming conventions, or ensuring code quality standards. Provides project-specific coding standards and best practices.
230-
version: 1.0.0
231230
---
232231

233232
# Code Standards

0 commit comments

Comments
 (0)